> ## Documentation Index
> Fetch the complete documentation index at: https://docs.costa.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup opencode

<Callout icon="compass">
  Connect opencode to Costa. Turn on Trim. Build a Cosmic Router.
</Callout>

<div className="tw-reset costatw:my-4 costatw:px-4 costatw:py-2 costatw:rounded-lg costatw:text-sm costatw:bg-zinc-100 costatw:text-zinc-600 costatw:dark:bg-zinc-800/50 costatw:dark:text-zinc-400">
  Using a different tool? <a href="/get-started/claude-code">Claude Code</a> · <a href="/get-started/codex">Codex</a> · <a href="/integrations/other-agents">something else</a>
</div>

## Before you start

You'll need:

* **opencode** installed.
* A terminal you're comfortable in.

<Steps>
  <Step title="Install Costa">
    Copy this into your terminal and run it:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/costa-app/costa-cli/main/install.sh | sh -
    ```

    When the install finishes, Costa walks you through:

    1. Creating your Costa account.
    2. Picking a **callsign** — your public username on Costa.
    3. Landing on the **Integrations** menu.

    Stay in the TUI. The next step happens there.
  </Step>

  <Step title="Enable opencode">
    You're now on the Integrations tab. You'll see something like this:

    <pre style={{fontFamily: '"CommitMono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace', fontFeatureSettings: '"liga" 0, "calt" 0', fontVariantLigatures: 'none', whiteSpace: 'pre', lineHeight: 1, fontSize: '0.875rem', margin: 0, padding: '1rem 1.25rem'}}>
      {"\n  ╭──────────────────╮  ╭────────────╮  ╭─────────────╮  ╭──────────────╮\n  │  Integrations    │  │   Tokens   │  │   Threads   │  │   Settings   │\n  │                  │  ╰───────────────────────────────────────────────╯\n\n  Integration      Installed    Enabled    Token   Agent\n  ─────────────────────────────────────────────────────────\n  claude-code      ✓ yes        ✗ no       —       —\n  codex            ✓ yes        ✗ no       —       —\n  kilo             ✗ no         ✗ no       —       —\n▸ opencode         ✗ no         ✗ no       —       —\n\n  enter to enable costa"}
    </pre>

    Use the arrow keys to highlight **opencode**, then press **Enter**. Costa writes a token into `~/.config/opencode/opencode.json` and flips the row to **Enabled ✓**.

    **Restart opencode** so it picks up the new config.
  </Step>

  <Step title="Send your first prompt">
    Open opencode with `opencode` and ask it to do something real — fix a bug, write a test, refactor a file. Then open your [session dashboard](https://ai.costa.app/code/dashboard/sessions) and watch your messages stream in.

    You'll see the prompts, the model that handled it, the tool calls, and the running token count. That's Costa working underneath opencode. You can also view your [live dashboard](https://ai.costa.app/code/metrics/live) to see response times by provider and model.
  </Step>
</Steps>

<Card title="Next: Turn on Trim" icon="scissors" href="/get-started/trim" horizontal>
  Strip unused tokens before they reach the model.
</Card>