llummo

The official CLI for Llummo — real-time LLM cost tracking & proxy.

Track spend, manage proxy keys, and configure any AI SDK or terminal tool from your terminal.

Installation

# Run once without installing
npx llummo <command>

# Or install globally
npm install -g llummo

Quick start

1. Get a CLI token

Go to Dashboard → Settings → CLI Tokens and create a personal access token.

2. Authenticate

llummo login
# Paste your token when prompted

3. Init a project

cd my-app
llummo init

init detects your installed AI SDKs, lets you pick or create a proxy key, writes .env.local, and prints the exact code change needed. It also offers to set up native passthrough env vars for terminal tools like Claude Code, Cursor, and Aider — no code changes required.

Commands

| Command | Description | |---|---| | llummo login | Authenticate with a personal access token | | llummo whoami | Print the authenticated account email and plan | | llummo init | Configure the proxy in the current project | | llummo keys list | List all proxy keys | | llummo keys create [name] | Create a new proxy key (shown once — store it) | | llummo keys delete [id] | Revoke a proxy key | | llummo status | Show spend and token usage for the current period | | llummo status --from <YYYY-MM-DD> --to <YYYY-MM-DD> | Show usage for a custom date range |

SDK integration

After running llummo init, update your AI client to point at the proxy:

OpenAI

import OpenAI from "openai";

const client = new OpenAI({
  apiKey:  process.env.LLUMMO_PROXY_KEY,
  baseURL: process.env.LLUMMO_PROXY_URL,
});

Anthropic

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey:  process.env.LLUMMO_PROXY_KEY,
  baseURL: process.env.LLUMMO_PROXY_URL,
});

Mistral

import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({
  apiKey:     process.env.LLUMMO_PROXY_KEY,
  serverURL:  process.env.LLUMMO_PROXY_URL,
});

Terminal tools (zero code changes)

For Claude Code, Cursor, Aider, Continue.dev, and other terminal-native tools, llummo init writes provider-specific env vars so any tool that reads OPENAI_API_KEY / ANTHROPIC_API_KEY routes through Llummo automatically.

You can also set them manually in your shell:

# Anthropic / Claude Code
export ANTHROPIC_API_KEY=your_proxy_key
export ANTHROPIC_BASE_URL=https://llummo.com/api/proxy/anthropic

# OpenAI-compatible tools
export OPENAI_API_KEY=your_proxy_key
export OPENAI_BASE_URL=https://llummo.com/api/proxy/openai

Add to ~/.zshrc or ~/.bashrc to persist across sessions.

Authentication

The CLI uses Personal Access Tokens (PATs) stored in ~/.config/llummo/config.json. Tokens are scoped to your account and use the same plan limits as your dashboard session. They never expire but can be revoked at any time from Settings → CLI Tokens.

Links

• Dashboard
• Documentation
• npm package