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 --antigravity=yes --openai=yes --tmux=no

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 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 an Antigravity subscription (via cliproxy)?" (Provides Claude + Gemini via cliproxy/ prefix)
2. "Do you have access to OpenAI API?" (Enables openai/ models)

Help the user understand the tradeoffs:

• Antigravity via cliproxy provides Claude + Gemini routing.
• OpenAI is optional; it enables openai/ models.
• If the user has no providers, the plugin still works using OpenCode Zen free models (opencode/big-pickle). They can switch to paid providers later by editing ~/.config/opencode/oh-my-opencode-slim.json.

Step 3: Run the Installer

Based on answers, run:

bunx oh-my-opencode-slim@latest install --no-tui --antigravity=<yes|no> --openai=<yes|no>

Examples:

# Antigravity + OpenAI
bunx oh-my-opencode-slim@latest install --no-tui --antigravity=yes --openai=yes --tmux=no

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

# No providers (Zen free models only)
bunx oh-my-opencode-slim@latest install --no-tui --antigravity=no --openai=no --tmux=no

The installer automatically:

• Adds the plugin to ~/.config/opencode/opencode.json
• Configures cliproxy provider for Antigravity models
• Generates agent model mappings in ~/.config/opencode/oh-my-opencode-slim.json

Crucial Advice for the User:

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

Step 4: Install and Configure Cliproxy (if using Antigravity)

If the user selected Antigravity, guide them to install cliproxy:

macOS:

brew install cliproxyapi
brew services start cliproxyapi

Linux:

curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

Authenticate with Antigravity:

./cli-proxy-api --antigravity-login

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

---

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

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

Cliproxy Issues

If cliproxy is not working:

1. Check if the service is running: ```bash

   macOS

   brew services list | grep cliproxy

# Linux ps aux | grep cli-proxy-api

2. Test the connection:
   ```bash
   curl http://127.0.0.1:8317/v1/models

1. Check your authentication: bash ./cli-proxy-api --antigravity-login

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
   

3. Stop cliproxy (if installed): ```bash

   macOS

   brew services stop cliproxyapi brew uninstall cliproxyapi

# Linux # Stop the service manually pkill cli-proxy-api # Remove the binary rm -f /usr/local/bin/cli-proxy-api ```