Agents
Any terminal program runs in a session (simstim new <host> -- <command>). The agents below are rows in the agent table (internal/agents), so simstim knows how to start them, how to resume them after a host restart, and how to tell when they need you.
| Support | Meaning |
|---|---|
| first-class | Tested end to end on every release; status from the agent’s own hooks; resumes after a reboot |
| supported | Tested when the test host has it |
| best-effort | In the table; contributors keep it working |
| Agent | --agent | Support | Program | Starts with | Resumes with | Status from | Inline mode |
|---|---|---|---|---|---|---|---|
| Claude Code | claude | first-class | claude | claude --session-id {session_uuid} | claude --resume {agent_session_id} | hooks, screen rules | CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 |
| Codex | codex | first-class | codex | codex --no-daemon | codex --no-daemon resume {agent_session_id} | hooks, screen rules | --no-alt-screen |
| opencode | opencode | supported | opencode | opencode | opencode -s {agent_session_id} | screen rules | — |
| Antigravity CLI | antigravity | supported | agy | agy | agy --conversation {agent_session_id} | output | — |
| Gemini CLI | gemini | best-effort | gemini | gemini --session-id {session_uuid} | gemini --resume {agent_session_id} | screen rules | — |
| Amp | amp | best-effort | amp | amp | amp threads continue {agent_session_id} | screen rules | — |
| Cursor CLI | cursor | best-effort | agent, cursor-agent | agent | agent --resume {agent_session_id} | output | — |
| Aider | aider | best-effort | aider | aider | aider --restore-chat-history | output | — |
| Goose | goose | best-effort | goose | goose session | goose session -r | output | — |
| Shell | shell | supported | $SHELL | $SHELL -l | $SHELL -l | output | — |
Inline mode is how an agent draws in the terminal’s normal screen, so your terminal keeps its scrollback. new --inline, or agents.inline in the configuration, starts agents that have one this way; see keep your scrollback.
Install and log in
simstim agents install <agent> runs the install command in a session on the host. host add and host doctor check each first-class and supported agent, and any other installed one: is it installed, does a login shell find it, and is it logged in. You log in yourself, with the agent’s own login in a session (install agents).
| Agent | Install command | Log in with | Logged in when |
|---|---|---|---|
| Claude Code | curl -fsSL https://claude.ai/install.sh | bash | claude auth login | ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN or CLAUDE_CODE_OAUTH_TOKEN is set; or claude auth status exits 0; or ~/.claude/.credentials.json exists |
| Codex | curl -fsSL https://chatgpt.com/codex/install.sh | sh | codex login --device-auth | codex login status exits 0; or ~/.codex/auth.json exists |
| opencode | curl -fsSL https://opencode.ai/install | bash | opencode auth login | ~/.local/share/opencode/auth.json exists |
| Antigravity CLI | curl -fsSL https://antigravity.google/cli/install.sh | bash | agy | unknown |
| Gemini CLI | npm install -g @google/gemini-cli | gemini | GEMINI_API_KEY or GOOGLE_API_KEY is set; or ~/.gemini/oauth_creds.json exists |
| Amp | curl -fsSL https://ampcode.com/install.sh | bash | amp login | AMP_API_KEY is set |
| Cursor CLI | curl https://cursor.com/install -fsS | bash | agent login | CURSOR_API_KEY is set |
| Aider | curl -LsSf https://aider.chat/install.sh | sh | — | ANTHROPIC_API_KEY or OPENAI_API_KEY is set |
| Goose | curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash | goose configure | unknown |
To add an agent, add a row to the table and, if it has them, screen rules in internal/agents/rules/. See the contributing guide.