Skip to main content

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.

Connect opencode to Costa. Turn on Trim. Build a Cosmic Router.
Using a different tool? Claude Code · Codex · something else

​
Before you start

You’ll need:
  • opencode installed.
  • A terminal you’re comfortable in.
1

Install Costa

Copy this into your terminal and run it:
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.
2

Enable opencode

You’re now on the Integrations tab. You’ll see something like this: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.
3

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 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 to see response times by provider and model.

Next: Turn on Trim

Strip unused tokens before they reach the model.