Skip to main content

Issue authentication keys with spending caps

Project description

capit_500

Budget per-agent, per-provider, as little or as much as you want

Ever been sticker shocked with a high inference bill only to find that the agent got stuck in some unproductive loop?

You need to manage the spending independent of the broken tool and broken agent.

capit, part of the DAY50 suite of open-source tools for AI workflows, allows for managing application-based key management with cost capping.

GUI

$ uvx capit serve
capit-ss

TUI

$ uvx capit openrouter 5.00 --agent openclaw
$5.00 openrouter key installed into openclaw
Old configuration backed up to /tmp/capit-openclaw-no22x7b1

That's it. Openclaw now has a capped API key. If it goes rogue, it can only cost you $5.

Everything is stored local-only or, optionally, not at all.

There are no capit servers and nothing is sent to us.


Supported Agents

Agent Config File Command
Claude Code ~/.claude/.credentials.json capit openrouter 5.00 --agent claude
Cursor ~/.config/Cursor/User/settings.json capit openrouter 5.00 --agent cursor
Windsurf ~/.config/Windsurf/User/settings.json capit openrouter 5.00 --agent windsurf
Hermes ~/.hermes/.env capit openrouter 5.00 --agent hermes
OpenClaw ~/.openclaw/secrets.json + openclaw.json capit openrouter 5.00 --agent openclaw
Opencode ~/.local/share/opencode/auth.json capit openrouter 5.00 --agent opencode

Run capit --agents to list all agents, or see agents/README.md for adding custom agents.


Install

uv tool install capit

Usage

Give an agent a budget

# Claude Code - $5 cap
capit openrouter 5.00 --agent claude

# Cursor - $10 cap
capit openrouter 10.00 --agent cursor

# Windsurf - $5 cap
capit openrouter 5.00 --agent windsurf

# Hermes - $5 cap
capit openrouter 5.00 --agent hermes

# OpenClaw - $5 cap
capit openrouter 5.00 --agent openclaw

# Opencode - $5 cap
capit openrouter 5.00 --agent opencode

Each agent gets its own capped key. Sleep soundly.

More agents

capit --agents  # List all supported agents

See agents/README.md for the full list and adding custom agents. The supported agents table above has details on each.

Platforms

The included platforms are openrouter, aihubmix, and concentrate.

Platforms are easy to create with a claude skill located in skills/platform-creator.md.

See platforms/README.md for more details.


Administration

capit --keys list              # List all keys with spending info
capit --keys list openrouter   # List keys from specific provider
capit --keys delete <name>     # Delete a key (e.g., claude-71ad2519)
capit --keys delete 'capit-*'  # Delete keys matching pattern
capit --platforms              # List available platforms
capit --platforms add          # Add a master key
capit --platforms remove       # Remove a master key
capit --agents                 # List supported agents

How It Works

  1. You run capit openrouter 5.00 --agent claude
  2. capit calls OpenRouter's API
  3. capit creates a guardrail with $5 cap
  4. capit creates an API key with that guardrail
  5. capit writes the key to ~/.claude/.credentials.json
  6. Done

The cap is enforced by OpenRouter. The key literally cannot spend more than $5.


MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

capit-0.9.0.tar.gz (56.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

capit-0.9.0-py3-none-any.whl (56.2 kB view details)

Uploaded Python 3

File details

Details for the file capit-0.9.0.tar.gz.

File metadata

  • Download URL: capit-0.9.0.tar.gz
  • Upload date:
  • Size: 56.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for capit-0.9.0.tar.gz
Algorithm Hash digest
SHA256 1ca6b7552df4e71f075c9e1167ee23ebc1d05cb5188cbce5b7dcb8e09c67b6ef
MD5 e1ddc939af2d7dfb5596bfad612762d3
BLAKE2b-256 be294a7e671b3cc25a1d07d3869825fdd9a3f42316785bb589b71cfdba89f776

See more details on using hashes here.

File details

Details for the file capit-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: capit-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 56.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for capit-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fa74bb9768632c79307f0c8d7cd412ce8762f0b0fd6c576f6b9feafa7254b2af
MD5 6001da7418febd1651d38cf84f2f945c
BLAKE2b-256 0d0a0a87dd6f23fdc89e1c14965090244c69eaa04a93ad2cb4b00c77cc6e675f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page