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 Codex to Costa. Turn on Trim. Build a Cosmic Router.
Using a different tool? Claude Code · opencode · something else

​
Before you start

You’ll need:
  • Codex CLI installed and signed in with a subscription.
  • A terminal you’re comfortable in.
Don’t have a Codex subscription? Get one from OpenAI →, use your own OpenAI API key →, or add another provider →.
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 Codex

You’re now on the Integrations tab. You’ll see something like this:Use the arrow keys to highlight codex, then press Enter. Costa writes a Costa profile into ~/.codex/config.toml and flips the row to Enabled ✓.Restart Codex so it picks up the new config.
3

Send your first prompt

Open Codex with codex 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 Codex. 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.