keypop 0.1.0

Simple CLI tool for storing and managing API keys

keypop

Simple CLI tool for storing and managing API keys securely.

Installation

Using pipx (recommended)

pipx install keypop

Using pip

pip install keypop

Quick Start

# Add your first key
keypop add openrouter sk-xxx...

# Get a key (masked by default) or export to .env
keypop get openrouter

keypop get openrouter --to-env .env

# List all keys
keypop list

# Export all keys to .env file
keypop export .env

# Update a key
keypop update openai sk-new-key

# Remove a key
keypop remove openai

Commands

add

Add a new API key.

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

Examples:

keypop add openai sk-abc123
keypop add github ghp_xxxxxxxxxxxx

If a key with the same name exists, you'll be prompted to overwrite.

---

get

Get a stored API key by name.

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

Options:

• --unmasked - Show the full key instead of masked version
• --to-env <file> - Write key to .env file (format: NAME=KEY)

Examples:

keypop get openai
keypop get openai --unmasked
keypop get openai --to-env .env.local

---

list

List all stored keys.

keypop list

Output:

NAME       KEY
------------------------------
openai     sk-abc***23
github     ghp_xxx***yz

---

update

Update an existing key's value.

keypop update <name> [new_key]

Options:

• Interactive mode if no arguments provided
• Non-interactive mode with name and new_key
• If key doesn't exist, prompts to create new one

Examples:

keypop update openai sk-new-key
keypop update openai        # Interactive mode

---

remove

Remove a stored key.

keypop remove <name>

You'll be prompted for confirmation before deletion.

Example:

keypop remove openai

---

export

Export all keys to a .env file.

keypop export [file]

Options:

• file - Target file path (default: .env)

Example:

keypop export .env
keypop export .env.production

Output format:

openai=sk-abc123
github=ghp_xxxxx

---

--version

Show version information.

keypop --version

Output: keypop CLI v0.1.0

---

Configuration

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

Security

Prevent keys from saving in shell history

When using keypop in interactive mode, keys are typed as input and may be saved in your shell history. To prevent this:

1. Open your shell config file:

   nano ~/.zshrc   # for Zsh
   # or
   nano ~/.bashrc  # for Bash
   

2. Add this line at the end:

   export HISTIGNORE="*keypop*"
   

3. Save and apply:

   source ~/.zshrc   # for Zsh
   # or
   source ~/.bashrc  # for Bash
   

Now all commands containing "keypop" will be ignored in your history.

License

MIT License - see LICENSE file for details.