keypop

Simple CLI tool and Python library for storing and managing API keys securely.

Features

• CLI — easy commands: keypop add openai sk-xxx
• Python Library — use in scripts: import keypop; keypop.get_key("openai")
• Export — migrate to .env files

Installation

Using pipx (recommended)

pipx install keypop

Using pip

pip install keypop

---

Quick Start

CLI

Add a key

keypop add openai sk-xxx

Get a key

keypop get openai

List all keys

keypop list

Export to .env

keypop export .env

Update a key

keypop update openai sk-new-key

Remove a key

keypop remove openai

Python Library

pip install keypop

import keypop

# Get single key
api_key = keypop.get_key("openai")

# Get all keys as dict
keys = keypop.all_keys()

---

CLI Commands

add

Add a new API key.

keypop add <name> <key>   # Non-interactive
keypop add               # Interactive mode

---

get

Get a stored API key.

keypop get <name> [--unmasked] [--to-env <file>]

Options:

• --unmasked — show full key
• --to-env — write to .env file

---

list

List all stored keys.

keypop list

---

update

Update an existing key.

keypop update <name> [new_key]

---

remove

Remove a stored key.

keypop remove <name>

---

export

Export all keys to .env file.

keypop export [file]

---

version

Show version.

keypop --version

---

Configuration

• Storage location: ~/.config/keypop/keys.json
• Created automatically on first use

---

Security

Prevent keys from saving in shell history

Add to ~/.zshrc or ~/.bashrc:

export HISTIGNORE="keypop"

Then run: source ~/.zshrc

---

License

MIT License — see LICENSE (LICENSE) file for details.