DOCS

Set up the Fee app and CLI.

Install the CLI, run the guided demo, inspect the receipt, then connect compatible tools to the gateway.

Set up Fee Tool gateway

INSTALL

Self-serve install

Current beta-user path: sign in, open the protected Fee download, run device login, then inspect the receipt. Public npm, brew aliases, and signed desktop binaries stay release-gated until the operator completes publish/signing.

open https://flatfee.one/download/fee
fee login --device
fee
fee receipts
fee doctor --live-contract --json

GATEWAY

One OpenAI-compatible base URL.

curl https://flatfee.one/v1/chat/completions \
  -H "Authorization: Bearer $FLATFEE_KEY" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Run this task"}]}'

Receipt contract

Every completed task returns a receipt with stable fields for audit, billing, and support.

{
  "requestId": "task_8f3k",
  "lane": "premium",
  "model": "auto",
  "tokens": { "prompt": 182400, "completion": 16420, "total": 198820 },
  "cost": 0.11,
  "currency": "EUR",
  "finish_reason": "stop",
  "fairUseRemaining": 0.82,
  "continuation": true
}

Do not build against legacy route, tokens_used, or cost_usd fields.

TOOL SETUP

Keep your tool. Change the endpoint.

Cursor

baseURL=https://flatfee.one/v1
model=auto
apiKey=$FLATFEE_KEY

Claude Code

ANTHROPIC_BASE_URL=https://flatfee.one/v1
ANTHROPIC_AUTH_TOKEN=$FLATFEE_KEY
model=auto

Aider

aider --openai-api-base https://flatfee.one/v1 --model auto

OpenCode

{ "provider": "flatfee", "baseURL": "https://flatfee.one/v1", "model": "auto" }

Custom SDK

client = createClient({ baseURL: "https://flatfee.one/v1", apiKey: process.env.FLATFEE_KEY })