Costa CLI

What is `costa` CLI?

costa is the command-line tool for managing Costa authentication and IDE / agent integrations. Use the CLI to:

Connect Costa to your AI coding tools (Claude Code, Codex, and more)
Check your Costa usage (sessions and points)
View your Costa threads (coming soon)

The Costa CLI safely configures your tools to use Costa’s API and models — no manual config editing required.

Installation

macOS
Linux
Windows

Homebrew (macOS)

brew install --cask costa-app/costa-cli/costa

Linux (amd64)

curl -LO https://github.com/costa-app/costa-cli/releases/latest/download/costa_<VERSION>_linux_amd64.tar.gz
tar xzf costa_*_linux_amd64.tar.gz
sudo mv costa /usr/local/bin/

How to use?

Authenticate

costa login

This opens your browser to complete OAuth authentication and securely stores credentials at:

~/.config/costa/token.json

Configure Claude Code

costa setup claude-code

This configures Claude Code (CLI or VS Code extension) to use Costa’s API.

~/.claude/settings.json

Verify setup

costa setup status claude-code

Getting Started

Core Concepts

Utilities

Integrations

What is `costa` CLI?

Installation

Homebrew (macOS)

Linux (amd64)

How to use?

Getting Started

Core Concepts

Utilities

Integrations

​What is costa CLI?

​Installation

​Homebrew (macOS)

​Linux (amd64)

​How to use?

What is `costa` CLI?

Installation

Homebrew (macOS)

Linux (amd64)

How to use?