[CLI Flag Review] 🔍 Weekly CLI Flag Consistency Report — 2026-07-05 #5925
Replies: 5 comments
-
|
🔮 The ancient spirits stir, and the smoke test agent has passed through this discussion. Warning Firewall blocked 8 domainsThe following domains were blocked by the firewall during workflow execution:
network:
allowed:
- defaults
- "accounts.google.com"
- "awmgmcpg"
- "clients2.google.com"
- "contentautofill.googleapis.com"
- "images.ctfassets.net"
- "redirector.gvt1.com"
- "registry.npmjs.org"
- "www.google.com"See Network Configuration for more information.
|
Beta Was this translation helpful? Give feedback.
-
|
🔮 The ancient spirits stir: the smoke test agent passed through the veil and leaves this omen in the discussion logs. Warning Firewall blocked 2 domainsThe following domains were blocked by the firewall during workflow execution:
network:
allowed:
- defaults
- "awmgmcpg"
- "registry.npmjs.org"See Network Configuration for more information.
|
Beta Was this translation helpful? Give feedback.
-
|
🔮 The ancient spirits stir: the smoke test agent has passed through this discussion, bearing a brief omen of success. Warning Firewall blocked 2 domainsThe following domains were blocked by the firewall during workflow execution:
network:
allowed:
- defaults
- "awmgmcpg"
- "registry.npmjs.org"See Network Configuration for more information.
|
Beta Was this translation helpful? Give feedback.
-
|
🔮 The ancient spirits stir... the smoke test agent was here. Warning Firewall blocked 2 domainsThe following domains were blocked by the firewall during workflow execution:
network:
allowed:
- defaults
- "awmgmcpg"
- "registry.npmjs.org"See Network Configuration for more information.
|
Beta Was this translation helpful? Give feedback.
-
|
🔮 The ancient spirits stir: the smoke test agent was here, and the firewall’s wards remain intact. Warning Firewall blocked 2 domainsThe following domains were blocked by the firewall during workflow execution:
network:
allowed:
- defaults
- "awmgmcpg"
- "registry.npmjs.org"See Network Configuration for more information.
|
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
Generated: 2026-07-05 | Run: 28739542890
📊 Summary
src/cli-options.ts)cli-reference.mdusage.mdKey concerns: 13 flags missing from
cli-reference.md, 9 missing fromusage.md, 1 description inaccuracy in--enable-api-proxy, 1 default value discrepancy in--dns-servers(AGENTS.md), and 1 stale file reference in AGENTS.md.✅ Flag Coverage Table
--vertex-api-target--vertex-api-base-path--openai-api-auth-header--anthropic-api-auth-header--max-model-multiplier--max-model-multiplier-cap--max-permission-denied--max-cache-misses--network-isolation--topology-attach--anthropic-auto-cache--anthropic-cache-tail-ttl--docker-host-path-prefix--enable-token-steering--enable-api-proxy--dns-serversAll other 50 flags: ✅ consistent across user-facing docs.
🔴 High Priority
1. Vertex AI flags undocumented —
--vertex-api-targetand--vertex-api-base-pathare implemented but absent fromcli-reference.mdandusage.md. Add alongside the Gemini API entries.2. Custom auth header flags undocumented —
--openai-api-auth-headerand--anthropic-api-auth-headermissing fromcli-reference.mdandusage.md. Needed for users integrating with custom OpenAI/Anthropic-compatible endpoints.3. API proxy safety/cost flags undocumented —
--max-model-multiplier,--max-model-multiplier-cap,--max-permission-denied,--max-cache-missesall missing fromcli-reference.mdandusage.md. These control cost containment and credential-error halting behavior.🟡 Medium Priority
4.
cli-reference.mdOptions Summary gaps —--network-isolation,--topology-attach,--anthropic-auto-cache,--anthropic-cache-tail-ttl, and--docker-host-path-prefixare missing from the Options Summary table despite being inusage.mdandAGENTS.md.5.
--enable-api-proxydescription is incomplete — Bothsrc/cli-options.tsanddocs/usage.mdsay "Supports OpenAI (Codex) and Anthropic (Claude) APIs" but the proxy also handles Copilot and Gemini/Vertex. Fix: "Supports OpenAI, Anthropic, Copilot, and Gemini/Vertex APIs."6.
--dns-serversdefault discrepancy in AGENTS.md — AGENTS.md states "Default: Google DNS (8.8.8.8,8.8.4.4)" but there is no static default; servers are auto-detected from host resolvers with Google DNS as fallback.cli-reference.mdis already correct.7.
--enable-token-steeringmissing fromusage.md— Present incli-reference.mdandAGENTS.mdbut absent fromusage.md.🔵 Low Priority
8. AGENTS.md stale file reference — Architecture section attributes argument parsing to
src/cli.ts, but flag definitions live insrc/cli-options.ts.src/cli.tsis now just a thin entry point.📋 Prioritized Recommendations
--vertex-api-target/--vertex-api-base-pathtocli-reference.md+usage.md--openai-api-auth-header/--anthropic-api-auth-headertocli-reference.md+usage.md--max-model-multiplier,--max-model-multiplier-cap,--max-permission-denied,--max-cache-missestocli-reference.md+usage.mdcli-reference.mdOptions Summary with the 5 missing mid-tier flags--enable-api-proxydescription insrc/cli-options.tsanddocs/usage.md--dns-serversdefault description inAGENTS.mdAGENTS.mdArchitecture section to referencesrc/cli-options.ts📁 Files Analyzed
src/cli-options.tssrc/commands/subcommands.tspredownload,logs,logs stats,logs summary,logs auditdocs-site/src/content/docs/reference/cli-reference.mddocs/usage.mdREADME.mdAGENTS.mdCLAUDE.mdReport generated automatically by CLI Flag Consistency Checker.
Warning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
awmgmcpgSee Network Configuration for more information.
Beta Was this translation helpful? Give feedback.
All reactions