Omega OpenCode CLI (headless)
This skill uses the OpenCode CLI in non-interactive mode (opencode run) so other agents (Claude Code, Cursor, Codex, Copilot, etc.) can run OpenCode from scripts—no MCP server required.
Overview
Run OpenCode via scripts/ask-opencode.mjs. It invokes opencode run "…" [--model provider/model] [--format json] [--auto] and returns the response. Requires Node.js and the OpenCode CLI. For one-time setup, run /omega-opencode-setup. See references/installation.md and references/auth.md.
First-time setup
Run /omega-opencode-setup or:
node .claude/skills/omega-opencode-cli/scripts/verify-setup.mjs
How to run OpenCode (headless)
From the project root (where .claude lives):
node .claude/skills/omega-opencode-cli/scripts/ask-opencode.mjs "USER_PROMPT"
Options:
--model MODEL/-m—provider/model(optional#variant), e.g.anthropic/claude-sonnet-5,opencode/gpt-5.5,openai/gpt-5.2#high. List withopencode models.--json— maps to--format json; script prints extracted assistant text from JSON events.--auto/--sandbox— maps toopencode run --auto(auto-approve permissions that are not denied). Prefer for CI.--agent NAME— OpenCode agent to use.--attach URL— attach to a runningopencode serveinstance (e.g.http://localhost:4096).--timeout-ms N— wrapper timeout; exit124on expiry.
Examples:
node .claude/skills/omega-opencode-cli/scripts/ask-opencode.mjs "Review @src/main.js for bugs"
node .claude/skills/omega-opencode-cli/scripts/ask-opencode.mjs "Summarize this" --model anthropic/claude-sonnet-5
echo "Explain recursion" | node .claude/skills/omega-opencode-cli/scripts/ask-opencode.mjs
Slash commands
- /analyze — headless analysis
- /omega-opencode — flexible analysis/brainstorm entry
- /omega-opencode-setup — verify Node + OpenCode CLI
Auth
references/auth.md — opencode auth login, /connect, API keys, Zen/Go.
Failure handling
Do not fabricate OpenCode output. Return the real error and point at verify-setup / auth docs.
Copy and run
Copy the entire .claude folder into the target project. Details: references/copy-and-run.md.