@vericha/admin
v0.1.0
Published
Operator CLI to issue/revoke/inspect Vericha developer virtual keys (uses the master key — never given to developers).
Maintainers
Readme
@vericha/admin
Operator CLI to issue / revoke / inspect developer virtual keys on your Vericha gateway. It talks to LiteLLM's admin API with the master key, so it is an operator tool — never give it (or the master key) to developers, and never expose it as an unauthenticated endpoint.
vericha-admin key new --alias dev-alice --budget 5 --duration 1d --all-models
vericha-admin key info sk-...
vericha-admin key rm sk-...--all-models issues a key scoped to all models (models:[]) — a real Claude Code session
needs this or it 403s on opus. Without it the key is scoped to --model (default
claude-sonnet).
Configuration
| Setting | Resolved from |
| --- | --- |
| master key | VERICHA_MASTER_KEY, else LITELLM_MASTER_KEY in ./.env |
| gateway admin URL | --base, else VERICHA_ADMIN_URL, else http://localhost:4000 |
LiteLLM's admin port (4000) is loopback-bound, so run this on the gateway host or over an
SSH tunnel. Cross-platform (Node) — it replaces the per-OS create-virtual-key.{sh,ps1}
scripts so there are no shell-encoding or JSON-array footguns.
