Installation

The CLI provides command-line access to the Codecosts API.

Install

The CLI is a workspace package. Run it from the monorepo root:

bun run cli <command>

Configuration

The CLI stores its config at ~/.config/codecosts/config.json:

{
  "serverUrl": "http://localhost:3501",
  "apiKey": "sk_abc123..."
}

Field	Default	Description
serverUrl	http://localhost:3501	API server URL
apiKey	(none)	API key from login

Authenticate

Before using authenticated commands, log in:

bun run cli login

This opens your browser for sign-in, creates an API key, and saves it to the config file.

For headless/CI environments, pass an API key directly:

bun run cli login --api-key sk_your_api_key

Check auth status

bun run cli status

Server: http://localhost:3501
API key: set
Config: /Users/you/.config/codecosts/config.json