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

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, aihubmix, and unkey.

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.5.2.tar.gz (21.0 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.5.2-py3-none-any.whl (26.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for capit-0.5.2.tar.gz
Algorithm Hash digest
SHA256 55e216f74375e9134512dd7e49d94465365d50c88a2a0c1d566f855d84721795
MD5 8cce41a426ccc9eb894a553ddaf684a9
BLAKE2b-256 a1fd5c95c6387e038a9a9ad6fec60d7634ecb9d231559064993e4e05337aa4fb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: capit-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 26.7 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.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b073be10e217a2fea1a24e43344e87f3e145b99dfa24427a4de5744691902b3b
MD5 5fb00797312604e1f8d8217fd5f366be
BLAKE2b-256 58ac83b494b492bf83bbd5ea48845ed4e936c85b3690365543f58592e8db88da

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