Document all remaining Oz CLI subcommands + new SSH setting#206
Closed
hongyi-chen wants to merge 6 commits into
Closed
Document all remaining Oz CLI subcommands + new SSH setting#206hongyi-chen wants to merge 6 commits into
hongyi-chen wants to merge 6 commits into
Conversation
…uperGrok Dogfoods the missing_docs drift-watch workflow on the standing findings backlog (41 findings resolved): - all-settings.mdx: documented 17 missing settings (prompt submission mode, orchestration message display, auto handoff on sleep, agent attribution, handoff kill-switches, OSC 52 clipboard access, async find, directory tab colors, vertical-tabs panel options, hidden files in project explorer, line number mode, force X11, Ctrl+Enter submit for CLI agents, input focus on block selection) with types/defaults/options extracted from the settings registry; moved git_operations_autogen_enabled into [agents.warp_agent.active_ai] reflecting the agents.oz -> agents.warp_agent rename and removed the stale remnant section; added an Experimental section - keyboard-shortcuts.mdx: fixed all 14 dead action names (10 renames like workspace:open_new_tab -> workspace:new_tab, editor_view:cmd_i -> editor_view:inspect_command, terminal:trigger_subshell_bootstrap -> terminal:warpify_subshell; 4 removed actions blanked) - slash-commands.mdx: added /environment, /harness, /host (cloud agent session selectors) and /rename-conversation - bring-your-own-api-key.mdx: documented connecting a SuperGrok subscription instead of an xAI API key (newly GA SuperGrok flag) + map entry - Surface map: allowlisted guides/agent-workflows/warp-vs-claude-code as intentionally unlisted (per its frontmatter note) - Re-applied the GA-flag reclassification from the previous session (15 mappings + FullScreenZenMode surfaced) which had been silently reverted by a 'git checkout' during integrity testing before it was committed \u2014 caught by comparing accounting bucket counts run-over-run - Snapshot re-baselined; audit now reports 0 stale doc references, 0 undocumented settings/slash commands/unlisted pages; remaining backlog: 29 CLI subcommand docs, 24 OpenAPI spec gaps (update-open-api-spec), 29 terminology pages (style_lint), FullScreenZenMode + GroupedTabs Co-Authored-By: Oz <oz-agent@warp.dev>
Co-Authored-By: Oz <oz-agent@warp.dev>
- reference/cli/index.mdx: fix mislabeled 'oz agent list' (it lists your team's cloud agents; skill listing is 'oz agent skills') and add reference sections for oz agent get/create/update/delete, oz agent skills, oz run conversation get, oz run message (send/list/read/mark-delivered/watch), oz schedule (create/list/get/update/pause/unpause/delete), oz secret (create/list/update/delete), and oz provider (setup/list) - reference/cli/api-keys.mdx: add 'From the CLI' section covering oz api-key list/create/expire - all-settings.mdx: document new warpify.ssh.reuse_existing_control_master setting (caught by the audit as a surface change since the snapshot) - refresh surface snapshot Audit: undocumented_cli_commands 29 -> 0; undocumented_settings 1 -> 0. Co-Authored-By: Oz <oz-agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
…ch branch Co-Authored-By: Oz <oz-agent@warp.dev>
…ference branch Co-Authored-By: Oz <oz-agent@warp.dev>
…H notice setting Since the last snapshot, warp-internal added two settings and removed the SSHTmuxWrapper dogfood flag (tracked automatically; no map entry needed): - Documented cloud_platform.third_party_api_keys.gemini_enterprise_credentials_enabled in the all-settings reference - Mapped warpify.ssh.ssh_tmux_deprecation_notice_pending as internal (one-shot UI state, marked 'Internal:' in the settings registry) - Refreshed the surface snapshot Co-Authored-By: Oz <oz-agent@warp.dev>
Base automatically changed from
oz/missing-docs-first-driftwatch
to
oz/missing-docs-skill-overhaul
June 30, 2026 19:14
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Third PR in the missing_docs stack (#201 → #203 → this). Burns down the largest remaining audit backlog: the 29 undocumented Oz CLI subcommands, plus one new setting the drift-watch caught since the last snapshot.
Changes
reference/cli/index.mdxoz agent list— it previously described skill listing; it actually lists your team's cloud agents. Skill listing is documented under its real command,oz agent skills.oz agent get/create/update/delete(cloud agent management)oz agent skillsoz run conversation getoz run message(send,list,read,mark-delivered,watch)oz schedule(create,list,get,update,pause,unpause,delete)oz secret(createincl. provider forms for Claude/Codex,list,update,delete)oz provider setup/oz provider listreference/cli/api-keys.mdxoz api-key list/create/expire.terminal/settings/all-settings.mdxwarpify.ssh.reuse_existing_control_master(new since the last snapshot; flagged by the audit's surface diff assetting_added).Surface snapshot refreshed (
--update-snapshot) so the next scheduled diff doesn't re-flag the handled change.All flags and descriptions sourced from the clap definitions in the warp client repo (
crates/warp_cli/src/{agent,schedule,secret,api_key,provider,task}.rs).Validation
undocumented_cli_commands29 → 0,undocumented_settings1 → 0; completeness accounting clean (74 CLI commands = 8 hidden + 15 mapped + 51 doc-covered, 0 findings, 0 unaccounted).npm run buildpasses (338 pages).Conversation: https://staging.warp.dev/conversation/a706b73b-186b-456c-ad18-28390e36cb89
Run: https://oz.staging.warp.dev/runs/019eb51e-4d35-7d62-a494-331f39efbd67
Plans:
This PR was generated with Oz.