Key syncs and rotation for the vault you already use.
keypin.dev · Docs ·
Console · API keys
The keypin CLI is free and open source. No account, no server, and it never stores a value.
keypin is not a vault. It reads the one you already have, runs your apps with its keys, publishes them to CI and hosting, and rotates them. Nothing to commit, paste in a chat, or leave on a laptop.
Each project lists its keys in a keypin.toml: names, vault items and destinations, never values. keypin reads a
value only while a command runs.
| Vaults | Destinations | Rotation |
|---|---|---|
| 1Password | GitHub Actions | Resend |
| Infisical | Cloudflare Workers | Neon |
| Bitwarden | Vercel projects | OpenAI |
| Doppler | Supabase Functions | Supabase |
| AWS Secrets Manager | Netlify projects | Cloudflare API tokens |
| Railway services | OpenRouter | |
| Convex deployments | Google Cloud API keys | |
| Fly.io apps | ElevenLabs | |
| GitLab CI/CD | AWS IAM access keys | |
| SendGrid | ||
| Twilio API keys | ||
| xAI | ||
| Google Cloud service account keys | ||
| MongoDB Atlas | ||
| Secrets you generate |
Want another? Vote for it on the roadmap.
keypin runs on macOS, and on Linux with glibc (not Alpine), on arm64 or x64.
npm install -g keypincd ~/code/my-project
keypin init # write keypin.toml
keypin check # what the project uses, what's missing, and what to run or addcheck starts with the logins and apps you still need to set up, if any.
Move the secrets from your .env into 1Password, then run your app with them:
keypin import .env STRIPE_KEY DATABASE_URL --vault Private --account my.1password.com
keypin run -- npm run devimport creates one item per variable and maps it. Variables you don't name, such as PORT, stay in the file. See
Import.
Put each prod value in 1Password first:
- In a file:
keypin import .env.production STRIPE_KEY --env prod --vault Private - Only in GitHub or Cloudflare: neither keypin nor you can read it back, so make a new key at the provider.
Then keypin check prints the TOML to add for each secret a workflow or Worker needs:
[[keys.STRIPE_KEY.prod.publish]]
to = "github-actions"
repo = "me/my-project"Paste it into keypin.toml and replace each <...>. For a key you didn't import, from takes its reference: in
1Password, open the field's menu and select Copy Secret Reference.
Then publish:
keypin publish --allpublish shows what it will write where and waits for you to answer y.
A GitHub Actions job can instead read a key from your vault at job time, without a copy published to it. With AWS Secrets Manager or Infisical it signs in with OIDC. See Pulling in CI.
To rotate a key, give it an
issuer and run keypin rotate RESEND_API_KEY. keypin creates the new key, saves and publishes it, and asks before it revokes the old one.
keypin init [folder] # write keypin.toml and register the project
keypin check [folder] # report one project; writes nothing
keypin import <env-file> [NAME...] [--env <name>] --vault <vault>
# move an env file's values into 1Password and map them
keypin run [--only NAME] -- <command> # run a command with the dev keys, or only the named ones
keypin publish <VARIABLE> | --all # write prod keys to their destinations
keypin rotate <VARIABLE> # replace a key at its provider, then publish it
keypin status # every project's keys, and when each is due for rotation
keypin unregister [folder] # stop listing a projectkeypin <command> --help lists every option, and keypin --help the exit codes.
The keypin skill teaches a coding agent to use keypin without seeing values, and to hand each approval back to you:
npx skills add caiopizzol/keypin # this project
npx skills add caiopizzol/keypin -g # all your projects- Configuration: every field in
keypin.toml - Import: moving an env file's values into 1Password
- Infisical, Bitwarden, Doppler and AWS Secrets Manager: reading keys from them instead
- Service account: 1Password on a server or in CI
- Publishing: destinations, approvals and
--plan - Scheduled rotation: rotating 1Password keys in your GitHub Actions
- Notes:
wrangler dev, signing in to Cloudflare, and the files keypin keeps - API keys: where to get each key, how to set it and how to replace it
- Development: working on keypin