Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.crewship.ai/llms.txt

Use this file to discover all available pages before exploring further.

opencode-ai (v1.14.33+). Active upstream is github.com/anomalyco/opencode (sst/opencode redirects there).

​
Install

npm install -g opencode-ai

​
Auth (BYOK across 75+ providers)

OpenCode reads provider credentials from env vars based on which provider/model you pick. Crewship’s apiKeyEnvVarsForAdapter("OPENCODE") accepts:
Env varProvider
ANTHROPIC_API_KEYAnthropic
OPENAI_API_KEYOpenAI
GOOGLE_API_KEY / GEMINI_API_KEYGoogle
OPENROUTER_API_KEYOpenRouter
XAI_API_KEYxAI / Grok
GROQ_API_KEYGroq
DEEPSEEK_API_KEYDeepSeek
Add any of the above as a SECRET-type credential and assign to your OpenCode agent.

​
Models

OpenCode requires provider/model namespaced strings (NOT bare IDs). Curated picker entries: 
anthropic/claude-opus-4-7 | anthropic/claude-sonnet-4-6 | anthropic/claude-haiku-4-5
openai/gpt-5.5 | openai/gpt-5.4 | openai/gpt-5.4-mini | openai/gpt-5.3-codex
google/gemini-3.1-pro-preview | google/gemini-2.5-pro | google/gemini-2.5-flash
xai/grok-4.1-fast | xai/grok-4
deepseek/deepseek-v4-flash | deepseek/deepseek-r1
groq/llama-3.3-70b-versatile | groq/qwen-2.5-coder-32b
moonshotai/kimi-k2.6 | zai/glm-5.1
openrouter/anthropic/claude-sonnet-4-6

​
Command shape

opencode run --format json --model <provider/model> -- <user message>
--format json (NOT --output-format) emits JSONL events.

​
MCP

Configured at /output/<slug>/opencode.json: 
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fs": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/work"],
      "environment": {"FOO": "{env:FOO}"},
      "enabled": true
    },
    "linear": {
      "type": "remote",
      "url": "https://mcp.linear.app/sse",
      "headers": {"Authorization": "Bearer {env:LINEAR_TOKEN}"},
      "enabled": true
    }
  }
}
OpenCode-specific:
  • Top key is mcp (NOT mcpServers)
  • type: local (stdio) or remote (HTTP/SSE)
  • command is an ARRAY (binary + args together)
  • env field is environment (NOT env)
  • Env-var syntax is {env:VAR} (NOT ${VAR}) — Crewship translates standard ${VAR} form on write

​
Memory

AGENTS.md is OpenCode’s auto-discovered system instructions file. Crewship writes it as part of the canonical memory set. For turn-1 parity (OpenCode discovers AGENTS.md on the second invocation, not the first), the orchestrator also prepends the preamble inline with [SYSTEM]/[USER] delimiters on the first turn — turn-2+ uses the file.

​
Output stream

Flat JSONL per packages/opencode/src/cli/cmd/run.ts: 
{type: "text", sessionID: "...", part: {id, text}}
{type: "reasoning", part: {text}}
{type: "tool_use", part: {id, tool, state: {status, input, output}}}
{type: "step_start", part: {}}
{type: "step_finish", part: {tokens, cost, providerID, modelID}}
{type: "error", error: "..."}
Note type IS the part type at top level — NOT a nested message.part.updated envelope. step_finish (snake_case, NOT hyphen).

​
Troubleshooting

Bare model rejected — use provider/model form (anthropic/claude-sonnet-4-6 not claude-sonnet-4-6). MCP server uses literal ${VAR} token — Cursor/Claude ${VAR} syntax incompatible; ensure Crewship’s writer translated to {env:VAR}. Check by cat /output/<slug>/opencode.json.