Closes #884 ## What changed `--agent` now behaves like algorithm names, parameter names, and `--kind`: a value that matches exactly one built-in worker short ref once case and `-`/`_` are ignored resolves to it (`claude-code` → `claude_code`, `openai-compatible` → `openai_compatible`). Written specs use the canonical `agent.ref`. Kind mismatch checks still run on the folded name (`--agent claude-code` on kind=text is still refused as a WorkspaceAgent). Install-only aliases that are not a spelling fold (`deepseek-harness`, `claudecode`, `open-code`) still hint; `grok-bot` still explains it has no worker CLI. ## Verification at the tip Ran: - pytest -q tests/test_init_honor_agent.py tests/test_changelog_fragments.py tests/test_init_default_agent.py tests/test_workspace_agent_hint.py tests/test_cli_json_usage_errors.py tests/test_cli_algorithms_run.py tests/test_install_host_aliases.py → passed - live `init --agent claude-code` / `--agent openai-compatible` write the canonical refs; `grok-bot` and `kind=text --agent claude-code` still refuse Not run: - full suite — CI covers 3.9–3.13

Commits

Commits on Nov 8, 2026

fix(cli): fold hyphen/case --agent names