Delegate coding tasks to OpenCode CLI agent for feature implementation, refactoring, PR review, and long-running autonomous sessions. Requires the opencode CLI installed and authenticated.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Delegate coding tasks to OpenCode CLI agent for feature implementation, refactoring, PR review, and long-running autonomous sessions. Requires the opencode CLI installed and authenticated.
Use OpenCode as an autonomous coding worker orchestrated by Hermes terminal/process tools. OpenCode is a provider-agnostic, open-source AI coding agent with a TUI and CLI.
When to Use
User explicitly asks to use OpenCode
You want an external coding agent to implement/refactor/review code
You need long-running coding sessions with progress checks
You want parallel task execution in isolated workdirs/worktrees
Prerequisites
OpenCode installed: or
npm i -g opencode-ai@latest
brew install anomalyco/tap/opencode
Auth configured: opencode auth login or set provider env vars (OPENROUTER_API_KEY, etc.)
Verify: opencode auth list should show at least one provider
Git repository for code tasks (recommended)
pty=true for interactive TUI sessions
Binary Resolution (Important)
Shell environments may resolve different OpenCode binaries. If behavior differs between your terminal and Hermes, check:
terminal(command="which -a opencode")
terminal(command="opencode --version")
If needed, pin an explicit binary path:
terminal(command="$HOME/.opencode/bin/opencode run '...'", workdir="~/project", pty=true)
One-Shot Tasks
Use opencode run for bounded, non-interactive tasks:
terminal(command="opencode run 'Add retry logic to API calls and update tests'", workdir="~/project")
Attach context files with -f:
terminal(command="opencode run 'Review this config for security issues' -f config.yaml -f .env.example", workdir="~/project")
Show model thinking with --thinking:
terminal(command="opencode run 'Debug why tests fail in CI' --thinking", workdir="~/project")
Force a specific model:
terminal(command="opencode run 'Refactor auth module' --model openrouter/anthropic/claude-sonnet-4.6", workdir="~/project")
Interactive Sessions (Background)
For iterative work requiring multiple exchanges, start the TUI in background:
terminal(command="opencode", workdir="~/project", background=true, pty=true)
# Returns session_id
# Send a prompt
process(action="submit", session_id="<id>", data="Implement OAuth refresh flow and add tests")
# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")
# Send follow-up input
process(action="submit", session_id="<id>", data="Now add error handling for token expiry")
# Exit cleanly — Ctrl+C
process(action="write", session_id="<id>", data="\x03")
# Or just kill the process
process(action="kill", session_id="<id>")
Important: Do NOT use /exit — it is not a valid OpenCode command and will open an agent selector dialog instead. Use Ctrl+C (\x03) or process(action="kill") to exit.
TUI Keybindings
Key
Action
Enter
Submit message (press twice if needed)
Tab
Switch between agents (build/plan)
Ctrl+P
Open command palette
Ctrl+X L
Switch session
Ctrl+X M
Switch model
Ctrl+X N
New session
Ctrl+X E
Open editor
Ctrl+C
Exit OpenCode
Resuming Sessions
After exiting, OpenCode prints a session ID. Resume with:
terminal(command="opencode -c", workdir="~/project", background=true, pty=true) # Continue last session
terminal(command="opencode -s ses_abc123", workdir="~/project", background=true, pty=true) # Specific session
Common Flags
Flag
Use
run 'prompt'
One-shot execution and exit
--continue / -c
Continue the last OpenCode session
--session <id> / -s
Continue a specific session
--agent <name>
Choose OpenCode agent (build or plan)
--model provider/model
Force specific model
--format json
Machine-readable output/events
--file <path> / -f
Attach file(s) to the message
--thinking
Show model thinking blocks
--variant <level>
Reasoning effort (high, max, minimal)
--title <name>
Name the session
--attach <url>
Connect to a running opencode server
Procedure
Verify tool readiness:
terminal(command="opencode --version")
terminal(command="opencode auth list")
For bounded tasks, use opencode run '...' (no pty needed).
For iterative tasks, start opencode with background=true, pty=true.
Monitor long tasks with process(action="poll"|"log").
If OpenCode asks for input, respond via process(action="submit", ...).
Exit with process(action="write", data="\x03") or process(action="kill").
Summarize file changes, test results, and next steps back to user.
