abracadabra
Biometric-gated secrets vault that lets AI agents fetch credentials without a human in the loop.
- Year
- 2026
- Role
- Solo build — vault, local API, MCP server, npm distribution
- Discipline
- AI Tooling
The problem
Every autonomous coding agent hits the same wall: it needs an API key, and the only way to get one is to ask a human to paste it into the chat. That leaks the secret into transcripts, logs, and pull requests, it blocks the agent until someone is at the keyboard, and it leaves credentials scattered across stale .env files with no rotation story.
The approach
abracadabra is a local vault with a loopback API on 127.0.0.1:7331. Secrets live in the OS keystore — Keychain behind Touch ID on macOS, keytar on Linux and Windows, with an encrypted passphrase file as a portable fallback. Agents retrieve secrets by name over that API using a scoped, expiring bearer key, so the value never enters the conversation; an MCP server offers the same access interactively, where one biometric approval grants a TTL-bounded window of silent reads. A subprocess wrapper injects the resolved secrets into any command's environment without writing them to disk. The human performs exactly one high-trust action — issuing a scoped key — and the agent operates autonomously afterward.
Outcome
Published to npm as @userdefault/abracadabra and used as the credential layer for the GotchiBot agent fleet. Secrets sync between machines over USB or LAN as sealed cartridges, so a new laptop never requires re-pasting a key.
Details
- Loopback secrets API on 127.0.0.1:7331 — values are fetched by name, never pasted
- Touch ID / Keychain on macOS; keytar on Linux and Windows; encrypted passphrase-file fallback
- Scoped, expiring API keys per agent, plus an MCP server for interactive sessions
- Subprocess wrapper injects env vars invisibly — nothing written to disk
- Sealed USB / LAN sync for moving a vault between machines
- Cross-platform keystore support verified by CI smoke tests on macOS, Linux, and Windows
- Full activation gated by an on-chain licence NFT; released under PolyForm Noncommercial at v1.0.2
Built with
- TypeScript
- Node.js
- MCP
- Keychain
- REST API
- Vitest
Links
Need something like this? AI Tooling & Developer Infrastructure is what I do.
Related work
cron402
2026Cron-as-a-service for AI agents, billed per run in USDC over the x402 protocol — no accounts, no API keys.
AI ToolingGotchi Trader
2026Numer.ai-style research platform for multi-chain DEX trading, with honest paper-trading accounting.
AI Tooling
Last updated .