oh-my-opencode-slim/docs/installation.md

Installation Guide

Complete installation instructions for oh-my-opencode-slim.

Table of Contents

• For Humans
• For LLM Agents
• Troubleshooting
• Uninstallation

---

For Humans

Quick Install

Run the interactive installer:

bunx oh-my-opencode-slim@latest install

Or use non-interactive mode:

bunx oh-my-opencode-slim@latest install --no-tui --kimi=yes --openai=yes --antigravity=yes --chutes=yes --opencode-free=yes --opencode-free-model=auto --tmux=no --skills=yes

Provider Options

The installer supports multiple providers:

• OpenCode Free Models: Live-refreshed free opencode/* models
• Kimi For Coding: High-performance coding models
• OpenAI: GPT-4 and GPT-3.5 models
• Antigravity (Google): Claude 4.5 and Gemini 3 models via Google's infrastructure
• Chutes: Live-refreshed chutes/* models via OpenCode auth flow

When OpenCode free mode is enabled, the installer runs:

opencode models --refresh --verbose

It then filters to free opencode/* models only, picks a coding-first primary model, and picks a support model for search/implementation agents.

Enable during installation:

bunx oh-my-opencode-slim install --kimi=yes --openai=yes --antigravity=yes --chutes=yes --opencode-free=yes --opencode-free-model=auto

After Installation

Authenticate with your providers:

opencode auth login
# Select your provider → Complete OAuth flow
# Repeat for each provider you enabled

Once authenticated, run opencode and ping all agents to verify all agents respond.

💡 Tip: Models are fully customizable. The installer sets sensible defaults, but you can assign any model to any agent. Edit ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc for comments support) to override models, adjust reasoning effort, or disable agents entirely. See Configuration for details.

Alternative: Ask Any Coding Agent

Paste this into Claude Code, AmpCode, Cursor, or any coding agent:

Install and configure by following the instructions here:
https://raw.githubusercontent.com/alvinunreal/oh-my-opencode-slim/refs/heads/master/README.md

---

For LLM Agents

If you're an LLM Agent helping set up oh-my-opencode-slim, follow these steps.

Step 1: Check OpenCode Installation

opencode --version

If not installed, direct the user to https://opencode.ai/docs first.

Step 2: Ask About Provider Access

Ask these questions one at a time, waiting for responses:

1. "Do you have access to Kimi For Coding?" (Provides Kimi k1.5 models)
2. "Do you have access to OpenAI API?" (Enables openai/ models)
3. "Do you have access to Antigravity (Google)?" (Enables google/ models via Antigravity)
4. "Do you want to use Chutes?" (Enables chutes/ models with daily-cap aware selection)
5. "Do you want to use OpenCode free models?" (Refreshes and selects from free opencode/* models)

Help the user understand the tradeoffs:

• OpenCode free mode discovers the latest free opencode/* models using opencode models --refresh --verbose.
• OpenCode-only mode can assign more than one OpenCode model across agents.
• Hybrid mode can combine OpenCode free models with OpenAI, Kimi, and/or Antigravity.
• In hybrid mode, designer remains on the external provider mapping.
• Chutes selection prioritizes stronger models for orchestrator/oracle and higher-cap models for support agents.
• Kimi For Coding provides powerful coding models.
• OpenAI enables openai/ models.
• Antigravity (Google) provides Claude and Gemini models via Google infrastructure.
• Chutes uses OpenCode provider authentication (opencode auth login -> select chutes).
• Optional external ranking signals:
  • ARTIFICIAL_ANALYSIS_API_KEY (quality/coding/latency/price)
  • OPENROUTER_API_KEY (model pricing metadata) If set, installer dynamic planning uses these signals to improve model ranking.

Step 3: Run the Installer

Based on answers, run:

bunx oh-my-opencode-slim@latest install --no-tui --kimi=<yes|no> --openai=<yes|no> --antigravity=<yes|no> --chutes=<yes|no> --opencode-free=<yes|no> --opencode-free-model=<id|auto> --tmux=<yes|no> --skills=<yes|no>

Examples:

# Kimi + OpenAI + Antigravity
bunx oh-my-opencode-slim@latest install --no-tui --kimi=yes --openai=yes --antigravity=yes --chutes=yes --opencode-free=yes --opencode-free-model=auto --tmux=no --skills=yes

# OpenAI only
bunx oh-my-opencode-slim@latest install --no-tui --kimi=no --openai=yes --antigravity=no --chutes=no --opencode-free=no --tmux=no --skills=yes

# OpenCode free models only (auto-select)
bunx oh-my-opencode-slim@latest install --no-tui --kimi=no --openai=no --antigravity=no --chutes=no --opencode-free=yes --opencode-free-model=auto --tmux=no --skills=yes

# OpenCode free models + OpenAI (manual primary model)
bunx oh-my-opencode-slim@latest install --no-tui --kimi=no --openai=yes --antigravity=no --chutes=no --opencode-free=yes --opencode-free-model=opencode/gpt-5-nano --tmux=no --skills=yes

The installer automatically:

• Adds the plugin to ~/.config/opencode/opencode.json
• Generates agent model mappings in ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc)

Crucial Advice for the User:

• They can easily assign different models to different agents by editing ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc).
• If they add a new provider later, they just need to update this file.
• Read generated ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc) file and report the model configuration.

Step 4: Authenticate with Providers

For Kimi (if enabled): Ask user to run the following command. Don't run it yourself, it requires user interaction.

opencode auth login
# Select "Kimi For Coding" provider and complete OAuth flow

For OpenAI (if enabled): Ask user to run the following command. Don't run it yourself, it requires user interaction.

opencode auth login
# Select your provider and complete OAuth flow

For Antigravity (if enabled): Ask user to run the following command. Don't run it yourself, it requires user interaction.

opencode auth login
# Select "Antigravity (Google)" provider and complete OAuth flow

---

Troubleshooting

Installer Fails

Check the expected config format:

bunx oh-my-opencode-slim@latest install --help

Then manually create the config files at:

• ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc)

Agents Not Responding

1. Check your authentication:

   opencode auth status
   

2. Verify your config file exists and is valid:

   cat ~/.config/opencode/oh-my-opencode-slim.json
   

3. Check that your provider is configured in ~/.config/opencode/opencode.json

Authentication Issues

If providers are not working:

1. Check your authentication status:

   opencode auth status
   

2. Re-authenticate if needed:

   opencode auth login
   

3. Verify your config file has the correct provider configuration:

   cat ~/.config/opencode/oh-my-opencode-slim.json
   

Editor Validation

Add a $schema reference to your config for autocomplete and inline validation:

{
  "$schema": "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json",
  // your config...
}

Works in VS Code, Neovim (with jsonls), and any editor that supports JSON Schema. Catches typos and wrong nesting immediately (e.g., placing chains directly under fallback instead of fallback.chains).

Tmux Integration Not Working

Make sure you're running OpenCode with the --port flag and the port matches your OPENCODE_PORT environment variable:

tmux
export OPENCODE_PORT=4096
opencode --port 4096

See the Quick Reference for more details.

---

Uninstallation

1. Remove the plugin from your OpenCode config:

Edit ~/.config/opencode/opencode.json and remove "oh-my-opencode-slim" from the plugin array.

1. Remove configuration files (optional):

   rm -f ~/.config/opencode/oh-my-opencode-slim.json
   rm -f .opencode/oh-my-opencode-slim.json
   

2. Remove skills (optional):

   npx skills remove simplify
   npx skills remove agent-browser