⌬ OpenCode

OpenCode brings AI coding agents to your terminal. Run it as an interactive TUI, as a headless CLI for scripts and autonomous agents, as an HTTP API server, or as an ACP server for editors.

• Four ways to run: interactive TUI, headless -p mode, HTTP REST API with SSE, and ACP for Zed, JetBrains and AionUI
• Flows: deterministic multi-step agent workflows defined in YAML (guide)
• Agents and subagents: built-in and custom agents, defined in JSON or markdown (guide)
• Chat bridge: Telegram, Slack and Mattermost adapters with interactive questions and multi-reviewer fan-out (guide)
• Many providers: Anthropic, OpenAI, Gemini, AWS Bedrock, VertexAI, YandexCloud, Kimi and self-hosted (guide)
• Tools: files, shell, search, LSP, web fetch (guide), MCP servers, and host CLIs wrapped as workspace tools
• Tool control: allow-lists, granular permissions (guide) and on-demand deferred tools
• Structured output: enforce an agent's final answer with a JSON schema (guide)
• Skills, commands and hooks: skills, custom commands and Claude-Code-compatible hooks
• Long-running sessions: auto-compaction, background tasks, cron jobs and project memory
• Observability: Langfuse tracing of LLM calls, tools, tokens and cost (guide)
• Storage: sessions in SQLite or MySQL (guide)

# Install script (add VERSION=0.3.0 before bash for a specific version)
curl -fsSL https://raw.githubusercontent.com/obukhovaa/opencode/refs/heads/main/install | bash

# Homebrew
brew install obukhovaa/tap/opencode

# Go
go install github.com/obukhovaa/opencode@latest

opencode                                     # Start the TUI
opencode -a hivemind                         # Start with a specific agent
opencode -s <session-id>                     # Resume or create a session

opencode -p "Explain context in Go"          # Single prompt, non-interactive
opencode -p "Refactor this module" -f json -q -t 5m

opencode -p "Review it" -F review-code -A hash=93706ee   # Run a flow with args

opencode serve --port 8080                   # HTTP API server (docs/server.md)
opencode acp                                 # ACP server over stdio

All permissions are auto-approved in non-interactive mode.

opencode serve, opencode acp and opencode tools have their own flags: see --help, docs/server.md and docs/cli-tools.md.

OpenCode reads .opencode.json from the project directory, then $XDG_CONFIG_HOME/opencode/, then $HOME. A minimal config:

{
  "providers": {
    "anthropic": { "apiKey": "..." }
  },
  "agents": {
    "coder": { "model": "claude-4-5-sonnet[1m]", "maxTokens": 5000 }
  }
}

See docs/configuration.md for a full example, permissions and environment variables. Your editor can validate the file against opencode-schema.json.

git clone https://github.com/obukhovaa/opencode.git
cd opencode
make build    # build
make test     # lint and run all tests

Docker images, end-to-end tests and releases are covered in docs/development.md.

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

• @isaacphi — mcp-language-server, foundation for the LSP client
• @adamdottv — Design direction and UI/UX architecture
• @kujtimiihoxha – Original OpenCode implementation

MIT — see LICENSE.