3af30b0a21
Add configurable browser automation allowing users to choose between Playwright MCP (default) and Vercel's agent-browser CLI. Changes: - Add browser_automation_engine.provider config option - Dynamic skill loading based on provider selection - Comprehensive agent-browser CLI reference (inline in skills.ts) - Propagate browserProvider to delegate_task and buildAgent - Update documentation with provider comparison Co-authored-by: Suyeol Jeon <devxoul@gmail.com> Co-authored-by: YeonGyu Kim <code.yeongyu@gmail.com>
595 lines
26 KiB
Markdown
595 lines
26 KiB
Markdown
# Oh-My-OpenCode Configuration
|
|
|
|
Highly opinionated, but adjustable to taste.
|
|
|
|
## Quick Start
|
|
|
|
**Most users don't need to configure anything manually.** Run the interactive installer:
|
|
|
|
```bash
|
|
bunx oh-my-opencode install
|
|
```
|
|
|
|
It asks about your providers (Claude, OpenAI, Gemini, etc.) and generates optimal config automatically.
|
|
|
|
**Want to customize?** Here's the common patterns:
|
|
|
|
```jsonc
|
|
{
|
|
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
|
|
|
|
// Override specific agent models
|
|
"agents": {
|
|
"oracle": { "model": "openai/gpt-5.2" }, // Use GPT for debugging
|
|
"librarian": { "model": "zai-coding-plan/glm-4.7" }, // Cheap model for research
|
|
"explore": { "model": "opencode/gpt-5-nano" } // Free model for grep
|
|
},
|
|
|
|
// Override category models (used by delegate_task)
|
|
"categories": {
|
|
"quick": { "model": "opencode/gpt-5-nano" }, // Fast/cheap for trivial tasks
|
|
"visual-engineering": { "model": "google/gemini-3-pro" } // Gemini for UI
|
|
}
|
|
}
|
|
```
|
|
|
|
**Find available models:** Run `opencode models` to see all models in your environment.
|
|
|
|
## Config File Locations
|
|
|
|
Config file locations (priority order):
|
|
1. `.opencode/oh-my-opencode.json` (project)
|
|
2. User config (platform-specific):
|
|
|
|
| Platform | User Config Path |
|
|
| --------------- | ----------------------------------------------------------------------------------------------------------- |
|
|
| **Windows** | `~/.config/opencode/oh-my-opencode.json` (preferred) or `%APPDATA%\opencode\oh-my-opencode.json` (fallback) |
|
|
| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
|
|
|
|
Schema autocomplete supported:
|
|
|
|
```json
|
|
{
|
|
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json"
|
|
}
|
|
```
|
|
|
|
## JSONC Support
|
|
|
|
The `oh-my-opencode` configuration file supports JSONC (JSON with Comments):
|
|
- Line comments: `// comment`
|
|
- Block comments: `/* comment */`
|
|
- Trailing commas: `{ "key": "value", }`
|
|
|
|
When both `oh-my-opencode.jsonc` and `oh-my-opencode.json` files exist, `.jsonc` takes priority.
|
|
|
|
**Example with comments:**
|
|
|
|
```jsonc
|
|
{
|
|
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
|
|
|
|
/* Agent overrides - customize models for specific tasks */
|
|
"agents": {
|
|
"oracle": {
|
|
"model": "openai/gpt-5.2" // GPT for strategic reasoning
|
|
},
|
|
"explore": {
|
|
"model": "opencode/gpt-5-nano" // Free & fast for exploration
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Google Auth
|
|
|
|
**Recommended**: For Google Gemini authentication, install the [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth) plugin (`@latest`). It provides multi-account load balancing, variant-based thinking levels, dual quota system (Antigravity + Gemini CLI), and active maintenance. See [Installation > Google Gemini](docs/guide/installation.md#google-gemini-antigravity-oauth).
|
|
|
|
## Agents
|
|
|
|
Override built-in agent settings:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"explore": {
|
|
"model": "anthropic/claude-haiku-4-5",
|
|
"temperature": 0.5
|
|
},
|
|
"multimodal-looker": {
|
|
"disable": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Each agent supports: `model`, `temperature`, `top_p`, `prompt`, `prompt_append`, `tools`, `disable`, `description`, `mode`, `color`, `permission`.
|
|
|
|
Use `prompt_append` to add extra instructions without replacing the default system prompt:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"librarian": {
|
|
"prompt_append": "Always use the elisp-dev-mcp for Emacs Lisp documentation lookups."
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
You can also override settings for `Sisyphus` (the main orchestrator) and `build` (the default agent) using the same options.
|
|
|
|
### Permission Options
|
|
|
|
Fine-grained control over what agents can do:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"explore": {
|
|
"permission": {
|
|
"edit": "deny",
|
|
"bash": "ask",
|
|
"webfetch": "allow"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
| Permission | Description | Values |
|
|
| -------------------- | -------------------------------------- | --------------------------------------------------------------------------- |
|
|
| `edit` | File editing permission | `ask` / `allow` / `deny` |
|
|
| `bash` | Bash command execution | `ask` / `allow` / `deny` or per-command: `{ "git": "allow", "rm": "deny" }` |
|
|
| `webfetch` | Web request permission | `ask` / `allow` / `deny` |
|
|
| `doom_loop` | Allow infinite loop detection override | `ask` / `allow` / `deny` |
|
|
| `external_directory` | Access files outside project root | `ask` / `allow` / `deny` |
|
|
|
|
Or disable via `disabled_agents` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"disabled_agents": ["oracle", "multimodal-looker"]
|
|
}
|
|
```
|
|
|
|
Available agents: `oracle`, `librarian`, `explore`, `multimodal-looker`
|
|
|
|
## Built-in Skills
|
|
|
|
Oh My OpenCode includes built-in skills that provide additional capabilities:
|
|
|
|
- **playwright** (default) / **agent-browser**: Browser automation for web scraping, testing, screenshots, and browser interactions. See [Browser Automation](#browser-automation) for switching between providers.
|
|
- **git-master**: Git expert for atomic commits, rebase/squash, and history search (blame, bisect, log -S). STRONGLY RECOMMENDED: Use with `delegate_task(category='quick', load_skills=['git-master'], ...)` to save context.
|
|
|
|
Disable built-in skills via `disabled_skills` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"disabled_skills": ["playwright"]
|
|
}
|
|
```
|
|
|
|
Available built-in skills: `playwright`, `agent-browser`, `git-master`
|
|
|
|
## Browser Automation
|
|
|
|
Choose between two browser automation providers:
|
|
|
|
| Provider | Interface | Features | Installation |
|
|
|----------|-----------|----------|--------------|
|
|
| **playwright** (default) | MCP tools | Playwright MCP server with structured tool calls | Auto-installed via npx |
|
|
| **agent-browser** | Bash CLI | Vercel's CLI with session management, parallel browsers | Requires `bun add -g agent-browser` |
|
|
|
|
**Switch providers** via `browser_automation_engine` in `oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"browser_automation_engine": {
|
|
"provider": "agent-browser"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Playwright (Default)
|
|
|
|
Uses the official Playwright MCP server (`@playwright/mcp`). Browser automation happens through structured MCP tool calls.
|
|
|
|
### agent-browser
|
|
|
|
Uses [Vercel's agent-browser CLI](https://github.com/vercel-labs/agent-browser). Key advantages:
|
|
- **Session management**: Run multiple isolated browser instances with `--session` flag
|
|
- **Persistent profiles**: Keep browser state across restarts with `--profile`
|
|
- **Snapshot-based workflow**: Get element refs via `snapshot -i`, interact with `@e1`, `@e2`, etc.
|
|
- **CLI-first**: All commands via Bash - great for scripting
|
|
|
|
**Installation required**:
|
|
```bash
|
|
bun add -g agent-browser
|
|
agent-browser install # Download Chromium
|
|
```
|
|
|
|
**Example workflow**:
|
|
```bash
|
|
agent-browser open https://example.com
|
|
agent-browser snapshot -i # Get interactive elements with refs
|
|
agent-browser fill @e1 "user@example.com"
|
|
agent-browser click @e2
|
|
agent-browser screenshot result.png
|
|
agent-browser close
|
|
```
|
|
|
|
## Git Master
|
|
|
|
Configure git-master skill behavior:
|
|
|
|
```json
|
|
{
|
|
"git_master": {
|
|
"commit_footer": true,
|
|
"include_co_authored_by": true
|
|
}
|
|
}
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
| ------------------------ | ------- | -------------------------------------------------------------------------------- |
|
|
| `commit_footer` | `true` | Adds "Ultraworked with Sisyphus" footer to commit messages. |
|
|
| `include_co_authored_by` | `true` | Adds `Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>` trailer to commits. |
|
|
|
|
## Sisyphus Agent
|
|
|
|
When enabled (default), Sisyphus provides a powerful orchestrator with optional specialized agents:
|
|
|
|
- **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
|
|
- **OpenCode-Builder**: OpenCode's default build agent, renamed due to SDK limitations (disabled by default)
|
|
- **Prometheus (Planner)**: OpenCode's default plan agent with work-planner methodology (enabled by default)
|
|
- **Metis (Plan Consultant)**: Pre-planning analysis agent that identifies hidden requirements and AI failure points
|
|
|
|
**Configuration Options:**
|
|
|
|
```json
|
|
{
|
|
"sisyphus_agent": {
|
|
"disabled": false,
|
|
"default_builder_enabled": false,
|
|
"planner_enabled": true,
|
|
"replace_plan": true
|
|
}
|
|
}
|
|
```
|
|
|
|
**Example: Enable OpenCode-Builder:**
|
|
|
|
```json
|
|
{
|
|
"sisyphus_agent": {
|
|
"default_builder_enabled": true
|
|
}
|
|
}
|
|
```
|
|
|
|
This enables OpenCode-Builder agent alongside Sisyphus. The default build agent is always demoted to subagent mode when Sisyphus is enabled.
|
|
|
|
**Example: Disable all Sisyphus orchestration:**
|
|
|
|
```json
|
|
{
|
|
"sisyphus_agent": {
|
|
"disabled": true
|
|
}
|
|
}
|
|
```
|
|
|
|
You can also customize Sisyphus agents like other agents:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"Sisyphus": {
|
|
"model": "anthropic/claude-sonnet-4",
|
|
"temperature": 0.3
|
|
},
|
|
"OpenCode-Builder": {
|
|
"model": "anthropic/claude-opus-4"
|
|
},
|
|
"Prometheus (Planner)": {
|
|
"model": "openai/gpt-5.2"
|
|
},
|
|
"Metis (Plan Consultant)": {
|
|
"model": "anthropic/claude-sonnet-4-5"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
| ------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `disabled` | `false` | When `true`, disables all Sisyphus orchestration and restores original build/plan as primary. |
|
|
| `default_builder_enabled` | `false` | When `true`, enables OpenCode-Builder agent (same as OpenCode build, renamed due to SDK limitations). Disabled by default. |
|
|
| `planner_enabled` | `true` | When `true`, enables Prometheus (Planner) agent with work-planner methodology. Enabled by default. |
|
|
| `replace_plan` | `true` | When `true`, demotes default plan agent to subagent mode. Set to `false` to keep both Prometheus (Planner) and default plan available. |
|
|
|
|
## Background Tasks
|
|
|
|
Configure concurrency limits for background agent tasks. This controls how many parallel background agents can run simultaneously.
|
|
|
|
```json
|
|
{
|
|
"background_task": {
|
|
"defaultConcurrency": 5,
|
|
"providerConcurrency": {
|
|
"anthropic": 3,
|
|
"openai": 5,
|
|
"google": 10
|
|
},
|
|
"modelConcurrency": {
|
|
"anthropic/claude-opus-4-5": 2,
|
|
"google/gemini-3-flash": 10
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
| `defaultConcurrency` | - | Default maximum concurrent background tasks for all providers/models |
|
|
| `providerConcurrency` | - | Per-provider concurrency limits. Keys are provider names (e.g., `anthropic`, `openai`, `google`) |
|
|
| `modelConcurrency` | - | Per-model concurrency limits. Keys are full model names (e.g., `anthropic/claude-opus-4-5`). Overrides provider limits. |
|
|
|
|
**Priority Order**: `modelConcurrency` > `providerConcurrency` > `defaultConcurrency`
|
|
|
|
**Use Cases**:
|
|
- Limit expensive models (e.g., Opus) to prevent cost spikes
|
|
- Allow more concurrent tasks for fast/cheap models (e.g., Gemini Flash)
|
|
- Respect provider rate limits by setting provider-level caps
|
|
|
|
## Categories
|
|
|
|
Categories enable domain-specific task delegation via the `delegate_task` tool. Each category applies runtime presets (model, temperature, prompt additions) when calling the `Sisyphus-Junior` agent.
|
|
|
|
**Default Categories:**
|
|
|
|
| Category | Model | Description |
|
|
| ---------------- | ----------------------------- | ---------------------------------------------------------------------------- |
|
|
| `visual` | `google/gemini-3-pro` | Frontend, UI/UX, design-focused tasks. High creativity (temp 0.7). |
|
|
| `business-logic` | `openai/gpt-5.2` | Backend logic, architecture, strategic reasoning. Low creativity (temp 0.1). |
|
|
|
|
**Usage:**
|
|
|
|
```
|
|
// Via delegate_task tool
|
|
delegate_task(category="visual", prompt="Create a responsive dashboard component")
|
|
delegate_task(category="business-logic", prompt="Design the payment processing flow")
|
|
|
|
// Or target a specific agent directly
|
|
delegate_task(agent="oracle", prompt="Review this architecture")
|
|
```
|
|
|
|
**Custom Categories:**
|
|
|
|
Add custom categories in `oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"categories": {
|
|
"data-science": {
|
|
"model": "anthropic/claude-sonnet-4-5",
|
|
"temperature": 0.2,
|
|
"prompt_append": "Focus on data analysis, ML pipelines, and statistical methods."
|
|
},
|
|
"visual": {
|
|
"model": "google/gemini-3-pro",
|
|
"prompt_append": "Use shadcn/ui components and Tailwind CSS."
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Each category supports: `model`, `temperature`, `top_p`, `maxTokens`, `thinking`, `reasoningEffort`, `textVerbosity`, `tools`, `prompt_append`.
|
|
|
|
## Model Resolution System
|
|
|
|
At runtime, Oh My OpenCode uses a 3-step resolution process to determine which model to use for each agent and category. This happens dynamically based on your configuration and available models.
|
|
|
|
### Overview
|
|
|
|
**Problem**: Users have different provider configurations. The system needs to select the best available model for each task at runtime.
|
|
|
|
**Solution**: A simple 3-step resolution flow:
|
|
1. **Step 1: User Override** — If you specify a model in `oh-my-opencode.json`, use exactly that
|
|
2. **Step 2: Provider Fallback** — Try each provider in the requirement's priority order until one is available
|
|
3. **Step 3: System Default** — Fall back to OpenCode's configured default model
|
|
|
|
### Resolution Flow
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ MODEL RESOLUTION FLOW │
|
|
├─────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ Step 1: USER OVERRIDE │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ User specified model in oh-my-opencode.json? │ │
|
|
│ │ YES → Use exactly as specified │ │
|
|
│ │ NO → Continue to Step 2 │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │ │
|
|
│ ▼ │
|
|
│ Step 2: PROVIDER PRIORITY FALLBACK │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ For each provider in requirement.providers order: │ │
|
|
│ │ │ │
|
|
│ │ Example for Sisyphus: │ │
|
|
│ │ anthropic → github-copilot → opencode → antigravity │ │
|
|
│ │ │ │ │ │ │ │
|
|
│ │ ▼ ▼ ▼ ▼ │ │
|
|
│ │ Try: anthropic/claude-opus-4-5 │ │
|
|
│ │ Try: github-copilot/claude-opus-4-5 │ │
|
|
│ │ Try: opencode/claude-opus-4-5 │ │
|
|
│ │ ... │ │
|
|
│ │ │ │
|
|
│ │ Found in available models? → Return matched model │ │
|
|
│ │ Not found? → Try next provider │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │ │
|
|
│ ▼ (all providers exhausted) │
|
|
│ Step 3: SYSTEM DEFAULT │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Return systemDefaultModel (from opencode.json) │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### Agent Provider Chains
|
|
|
|
Each agent has a defined provider priority chain. The system tries providers in order until it finds an available model:
|
|
|
|
| Agent | Model (no prefix) | Provider Priority Chain |
|
|
|-------|-------------------|-------------------------|
|
|
| **Sisyphus** | `claude-opus-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **oracle** | `gpt-5.2` | openai → anthropic → google → github-copilot → opencode |
|
|
| **librarian** | `big-pickle` | opencode → github-copilot → anthropic |
|
|
| **explore** | `gpt-5-nano` | anthropic → opencode |
|
|
| **multimodal-looker** | `gemini-3-flash` | google → openai → zai-coding-plan → anthropic → opencode |
|
|
| **Prometheus (Planner)** | `claude-opus-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **Metis (Plan Consultant)** | `claude-sonnet-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **Momus (Plan Reviewer)** | `claude-opus-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **Atlas** | `claude-sonnet-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
|
|
### Category Provider Chains
|
|
|
|
Categories follow the same resolution logic:
|
|
|
|
| Category | Model (no prefix) | Provider Priority Chain |
|
|
|----------|-------------------|-------------------------|
|
|
| **visual-engineering** | `gemini-3-pro` | google → openai → anthropic → github-copilot → opencode |
|
|
| **ultrabrain** | `gpt-5.2-codex` | openai → anthropic → google → github-copilot → opencode |
|
|
| **artistry** | `gemini-3-pro` | google → openai → anthropic → github-copilot → opencode |
|
|
| **quick** | `claude-haiku-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **unspecified-low** | `claude-sonnet-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **unspecified-high** | `claude-opus-4-5` | anthropic → github-copilot → opencode → antigravity → google |
|
|
| **writing** | `gemini-3-flash` | google → openai → anthropic → github-copilot → opencode |
|
|
|
|
### Checking Your Configuration
|
|
|
|
Use the `doctor` command to see how models resolve with your current configuration:
|
|
|
|
```bash
|
|
bunx oh-my-opencode doctor --verbose
|
|
```
|
|
|
|
The "Model Resolution" check shows:
|
|
- Each agent/category's model requirement
|
|
- Provider fallback chain
|
|
- User overrides (if configured)
|
|
- Effective resolution path
|
|
|
|
### Manual Override
|
|
|
|
Override any agent or category model in `oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"agents": {
|
|
"Sisyphus": {
|
|
"model": "anthropic/claude-sonnet-4-5"
|
|
},
|
|
"oracle": {
|
|
"model": "openai/o3"
|
|
}
|
|
},
|
|
"categories": {
|
|
"visual-engineering": {
|
|
"model": "anthropic/claude-opus-4-5"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
When you specify a model override, it takes precedence (Step 1) and the provider fallback chain is skipped entirely.
|
|
|
|
## Hooks
|
|
|
|
Disable specific built-in hooks via `disabled_hooks` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"disabled_hooks": ["comment-checker", "agent-usage-reminder"]
|
|
}
|
|
```
|
|
|
|
Available hooks: `todo-continuation-enforcer`, `context-window-monitor`, `session-recovery`, `session-notification`, `comment-checker`, `grep-output-truncator`, `tool-output-truncator`, `directory-agents-injector`, `directory-readme-injector`, `empty-task-response-detector`, `think-mode`, `anthropic-context-window-limit-recovery`, `rules-injector`, `background-notification`, `auto-update-checker`, `startup-toast`, `keyword-detector`, `agent-usage-reminder`, `non-interactive-env`, `interactive-bash-session`, `compaction-context-injector`, `thinking-block-validator`, `claude-code-hooks`, `ralph-loop`, `preemptive-compaction`
|
|
|
|
**Note on `auto-update-checker` and `startup-toast`**: The `startup-toast` hook is a sub-feature of `auto-update-checker`. To disable only the startup toast notification while keeping update checking enabled, add `"startup-toast"` to `disabled_hooks`. To disable all update checking features (including the toast), add `"auto-update-checker"` to `disabled_hooks`.
|
|
|
|
## MCPs
|
|
|
|
Exa, Context7 and grep.app MCP enabled by default.
|
|
|
|
- **websearch**: Real-time web search powered by [Exa AI](https://exa.ai) - searches the web and returns relevant content
|
|
- **context7**: Fetches up-to-date official documentation for libraries
|
|
- **grep_app**: Ultra-fast code search across millions of public GitHub repositories via [grep.app](https://grep.app)
|
|
|
|
Don't want them? Disable via `disabled_mcps` in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"disabled_mcps": ["websearch", "context7", "grep_app"]
|
|
}
|
|
```
|
|
|
|
## LSP
|
|
|
|
OpenCode provides LSP tools for analysis.
|
|
Oh My OpenCode adds refactoring tools (rename, code actions).
|
|
All OpenCode LSP configs and custom settings (from opencode.json) are supported, plus additional Oh My OpenCode-specific settings.
|
|
|
|
Add LSP servers via the `lsp` option in `~/.config/opencode/oh-my-opencode.json` or `.opencode/oh-my-opencode.json`:
|
|
|
|
```json
|
|
{
|
|
"lsp": {
|
|
"typescript-language-server": {
|
|
"command": ["typescript-language-server", "--stdio"],
|
|
"extensions": [".ts", ".tsx"],
|
|
"priority": 10
|
|
},
|
|
"pylsp": {
|
|
"disabled": true
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Each server supports: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
|
|
|
|
## Experimental
|
|
|
|
Opt-in experimental features that may change or be removed in future versions. Use with caution.
|
|
|
|
```json
|
|
{
|
|
"experimental": {
|
|
"truncate_all_tool_outputs": true,
|
|
"aggressive_truncation": true,
|
|
"auto_resume": true
|
|
}
|
|
}
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
| --------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `truncate_all_tool_outputs` | `false` | Truncates ALL tool outputs instead of just whitelisted tools (Grep, Glob, LSP, AST-grep). Tool output truncator is enabled by default - disable via `disabled_hooks`. |
|
|
| `aggressive_truncation` | `false` | When token limit is exceeded, aggressively truncates tool outputs to fit within limits. More aggressive than the default truncation behavior. Falls back to summarize/revert if insufficient. |
|
|
| `auto_resume` | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues. |
|
|
|
|
**Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Description |
|
|
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `OPENCODE_CONFIG_DIR` | Override the OpenCode configuration directory. Useful for profile isolation with tools like [OCX](https://github.com/kdcokenny/ocx) ghost mode. |
|