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

$ 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.


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

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

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.

First time?

capit openrouter 5.00 --agent claude -i

The -i flag prompts for your OpenRouter management key once. It's used to create the capped key.


Platforms

The included platforms are openrouter and aihubmix.

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.6.0.tar.gz (26.8 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.6.0-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for capit-0.6.0.tar.gz
Algorithm Hash digest
SHA256 5972562fb21e1f1d51e01afdb76c02e442b24ba42c154ced00e2b82b89c232ce
MD5 e2e2698036283b74150559f3a04be3c1
BLAKE2b-256 446f4337466b1365e08f3b3d66df25b62e7ded96c26c97c64063cc50fbdcd116

See more details on using hashes here.

File details

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

File metadata

  • Download URL: capit-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 26.3 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.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 42a964cb2d7c863ae4477678c1ae9ed84d7ed8467b7c5be6f5bce564ca98cbdf
MD5 87d0002a7215b468f76c6b18d3aaaf3e
BLAKE2b-256 749dd7adb4266d0019d762fec90e3505f44c88c113c9066078a1d512e563cf7d

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