Skip to main content

Quick Start for the Full Stack

This page is the "Start Here" guide for the OpenCode stack in this repository. It is intentionally short and practical.

Step 1: Install the core components​

Follow these pages first:

At the end of that flow, you should have:

  • either a direct provider path (opencode / opencode-go) or a local proxy path (cliproxyapi)
  • Codex or other upstream providers authenticated
  • opencode installed and visible in your shell
  • oh-my-openagent loaded in your OpenCode setup

Step 2: Apply the useful tool layer​

The base install becomes much more useful once you add the operating layer around it.

Add these next:

Step 3: Launch and work​

opencode

Then:

  1. Switch models with /models
  2. Confirm your MCP tools are available
  3. Add AGENTS.md in your project if you want stricter workflow behavior
  4. Use local skills when a project has domain-specific rules
  • Verify cliproxyapi is reachable at http://localhost:8317/v1
  • Verify opencode --version
  • Verify your opencode.json points to CLIProxyAPI
  • Verify your chosen provider path matches how you actually want to route model traffic
  • Verify your oh-my-opencode.json or equivalent legacy config file is present and valid
  • Verify MCP servers you care about are enabled

Workflow structure​

This docs section separates the setup into install, tools, workflow, and reference pages so it stays easier to maintain than one giant document.

Next pages​