Adopt UX/DX conventions from the Codex/Gemini/Antigravity CLIs#143
Closed
alexkroman wants to merge 3 commits into
Closed
Adopt UX/DX conventions from the Codex/Gemini/Antigravity CLIs#143alexkroman wants to merge 3 commits into
alexkroman wants to merge 3 commits into
Conversation
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
auto-merge was automatically disabled
June 13, 2026 04:40
Pull request was closed
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
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.
Aligns the CLI with the conventions the leading agent CLIs converge on,
scoped to client-only changes:
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.
assembly configgroup (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.
assembly update: --check reports the latest release; otherwisedetects the install channel (brew/pipx/uv) and runs that channel's
own upgrade command, codex-update style.
NO_COLOR/FORCE_COLOR for late-created consoles and children).
(JSON-typed values, literal-string fallback), matching the
transcribe/stream --config convention.
(dictate: utterance, llm --follow: answer, batch transcribe: result;
stream/agent already had one).
assembly talias for transcribe (codexe/apattern).[EXPERIMENTAL] labeling convention).
config precedence, the stdin login recipe, and the NDJSON event
vocabulary; AGENTS.md records the new conventions.
https://claude.ai/code/session_013GPR7DWS56HmxWvCJgofPb