Reference¶

Complete CLI reference for OpenCode Initializer.

setup.sh — Bootstrap Orchestrator¶

The main entry point. Sources modules from src/lib/ and dispatches modes.

bash setup.sh [MODE] [OPTIONS]

Modes¶

Options¶

Examples¶

# Full install
bash setup.sh

# Health check
bash setup.sh --health

# Interactive mode
bash setup.sh --interactive

# CI/CD mode
bash setup.sh --ci

# New project
bash setup.sh --new ~/my-project

# With API keys
bash setup.sh --full --deepseek-key sk-xxxx --github-token ghp_xxxx

dev CLI — Post-Install Management¶

Available after installation at ~/opencode_initializer/dev.sh.

dev <command> [args]

Commands¶

Examples¶

# Check everything
dev health

# See what's outdated
dev version-check

# Install Docker if missing
dev install docker

# Remove Java
dev remove java

# Full system update
dev autoupdate

# Update opencode_initializer itself
dev self-update

opencode.json Schema¶

The configuration file for OpenCode AI assistant. Generated by 18-opencode-json.sh.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "deepseek/deepseek-v4-pro",
  "small_model": "deepseek/deepseek-v4-flash",
  "provider": {
    "deepseek": {},
    "opencode": {}
  },
  "instructions": ["AGENTS.md"],
  "mcpServers": {
    "github": { "type": "local", "command": ["node", "..."] },
    "filesystem": { "type": "local", "command": ["node", "..."] },
    "...": "..."
  },
  "plugins": [
    ["token-tracker@latest"],
    ["dcp@latest"],
    ["swarm@latest"],
    "..."
  ]
}

Provider Configuration¶

Providers are dynamically built based on available API keys (24 total):

Environment Variables¶

All variables are stored in ~/.config/opencode/secrets.env with chmod 600.

File Structure¶

~/.cache/opencode-setup/
  ├── progress            # Completed step tracking
  └── setup-*.log         # Timestamped install logs

~/.bun/bin/               # Bun binary cache (MCP cold start)

~/.config/opencode-setup/
  └── setup.conf          # Persistent settings

~/.config/opencode/
  └── secrets.env         # API keys (chmod 600)

~/opencode_initializer/
  ├── opencode.json       # Generated AI config
  ├── setup.sh            # Bootstrap orchestrator
  └── dev.sh              # Post-install CLI

Progress Tracking¶

The file ~/.cache/opencode-setup/progress records completed steps. Each module checks this file before running:

step_done "01-system"      # Check if already done
step_skip "01-system"      # Skip if done
# ... install packages ...
step_mark "01-system"      # Mark as done

Re-runs are idempotent — already-installed components are skipped.

Visual Progress¶

During setup, you'll see:

• Step counter: [3/29] Installing Node.js...
• Spinner: ⠋ Installing packages... during long operations
• Blurred log: ▌ Installing chromedriver via apt... for verbose output
• Colored status: [✓] green = done, [!] yellow = warning, [✗] red = error

Module Reference¶

See also: - MCP, LSP & Plugins — 24+12+18 component catalogue - Architecture — C4 diagrams and design decisions - User Guide — daily CLI usage - FAQ — troubleshooting and solutions