Skip to content

Adopt UX/DX conventions from the Codex/Gemini/Antigravity CLIs#146

Merged
alexkroman merged 4 commits into
mainfrom
claude/pr-143-errors-wdmiv3
Jun 13, 2026
Merged

Adopt UX/DX conventions from the Codex/Gemini/Antigravity CLIs#146
alexkroman merged 4 commits into
mainfrom
claude/pr-143-errors-wdmiv3

Conversation

@alexkroman

Copy link
Copy Markdown
Collaborator

Aligns the CLI with the conventions the leading agent CLIs converge on,
scoped to client-only changes:

  • login: new --with-api-key reads the key from stdin (Codex pattern) so
    it never reaches shell history or ps; --api-key becomes a hidden
    deprecation trap that still works but warns toward the stdin form.
    The browser-flow fallback now prints the exact ssh -L port-forward
    command (honoring AAI_AUTH_PORT) plus the stdin recipe for
    headless/SSH machines.
  • new assembly config group (path/list/get/set) over config.toml:
    switch the active profile, bind a profile's env, toggle telemetry —
    with bare pipe-friendly values on get/path.
  • new assembly update: --check reports the latest release; otherwise
    detects the install channel (brew/pipx/uv) and runs that channel's
    own upgrade command, codex-update style.
  • root --color auto|always|never (rebuilds the shared consoles and sets
    NO_COLOR/FORCE_COLOR for late-created consoles and children).
  • llm: --config KEY=VALUE escape hatch for any gateway request field
    (JSON-typed values, literal-string fallback), matching the
    transcribe/stream --config convention.
  • every NDJSON stream line now carries a "type" discriminator
    (dictate: utterance, llm --follow: answer, batch transcribe: result;
    stream/agent already had one).
  • hidden assembly t alias for transcribe (codex e/a pattern).
  • [sandbox] availability prefix on speak/dub help (codex
    [EXPERIMENTAL] labeling convention).
  • REFERENCE.md pins the script-facing contracts: exit codes, env vars,
    config precedence, the stdin login recipe, and the NDJSON event
    vocabulary; AGENTS.md records the new conventions.

https://claude.ai/code/session_013GPR7DWS56HmxWvCJgofPb

claude and others added 4 commits June 13, 2026 01:20
Aligns the CLI with the conventions the leading agent CLIs converge on,
scoped to client-only changes:

- login: new --with-api-key reads the key from stdin (Codex pattern) so
  it never reaches shell history or ps; --api-key becomes a hidden
  deprecation trap that still works but warns toward the stdin form.
  The browser-flow fallback now prints the exact ssh -L port-forward
  command (honoring AAI_AUTH_PORT) plus the stdin recipe for
  headless/SSH machines.
- new `assembly config` group (path/list/get/set) over config.toml:
  switch the active profile, bind a profile's env, toggle telemetry —
  with bare pipe-friendly values on get/path.
- new `assembly update`: --check reports the latest release; otherwise
  detects the install channel (brew/pipx/uv) and runs that channel's
  own upgrade command, codex-update style.
- root --color auto|always|never (rebuilds the shared consoles and sets
  NO_COLOR/FORCE_COLOR for late-created consoles and children).
- llm: --config KEY=VALUE escape hatch for any gateway request field
  (JSON-typed values, literal-string fallback), matching the
  transcribe/stream --config convention.
- every NDJSON stream line now carries a "type" discriminator
  (dictate: utterance, llm --follow: answer, batch transcribe: result;
  stream/agent already had one).
- hidden `assembly t` alias for transcribe (codex `e`/`a` pattern).
- [sandbox] availability prefix on speak/dub help (codex
  [EXPERIMENTAL] labeling convention).
- REFERENCE.md pins the script-facing contracts: exit codes, env vars,
  config precedence, the stdin login recipe, and the NDJSON event
  vocabulary; AGENTS.md records the new conventions.

https://claude.ai/code/session_013GPR7DWS56HmxWvCJgofPb
… claude/pr-143-errors-wdmiv3

# Conflicts:
#	AGENTS.md
#	aai_cli/main.py
#	tests/_snapshot_surface.py
@alexkroman alexkroman enabled auto-merge June 13, 2026 04:40
@alexkroman alexkroman added this pull request to the merge queue Jun 13, 2026
Merged via the queue into main with commit 8e39d2a Jun 13, 2026
16 checks passed
@alexkroman alexkroman deleted the claude/pr-143-errors-wdmiv3 branch June 13, 2026 04:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants