| name | ao-agent-shorthands |
| description | Read ~/.hermes/agent-orchestrator.yaml BEFORE declaring an --agent <X> value unsupported. Lists plugin shorthands (wafer, minimax, agy). |
AO provider agent shorthands (wafer, minimax, zai, agy/antigravity)
MANDATORY — resolve --agent from config before declaring unsupported:
When the user specifies --agent <X> and <X> is not a well-known CLI name you recognize, read ~/.hermes/agent-orchestrator.yaml (or the active AO config) FIRST. The defaults.agent key and installed plugins define agent shorthands. Never scan packages/agent-*/ directories as a substitute. Never declare an agent unsupported without reading the config.
head -20 ~/.hermes/agent-orchestrator.yaml
| Shorthand | Binary / mechanism | Notes |
|---|
--agent agy / --agent antigravity | ~/.local/bin/agy (Google Antigravity / Gemini CLI) | Default agent in ~/.hermes/agent-orchestrator.yaml (defaults.agent: antigravity) |
--agent wafer | claude CLI → https://pass.wafer.ai | WAFER_API_KEY, default model GLM-5.1 |
--agent minimax | claude CLI → https://api.minimax.io/anthropic | MINIMAX_API_KEY, server-selected model |
z.ai/model prefix | claude → https://api.z.ai/api/anthropic | GLM_API_KEY, model in prefix |
The claude-code plugin supports inline model prefixes for all three: wafer.ai/GLM-5.1, z.ai/claude-4, MiniMax-M2.7. Dedicated --agent plugins are preferred for wafer and minimax. Z.AI uses inline prefix only (no dedicated agent plugin).
Integration tests: packages/integration-tests/src/agent-{wafer,minimax,zai}.integration.test.ts — real tmux + real API, auto-skip when keys missing.
