Installing the CLI

The jfp CLI gives you terminal access to the entire JeffreysPrompts library.

The CLI is free to install and use with public prompts. Pro accounts unlock private vault access (list --mine, search --saved), plus save/sync, notes, collections, and premium packs.

Quick install

The fastest way to install jfp is using the install script:

curl -fsSL https://jeffreysprompts.com/install.sh | bash

This downloads the appropriate binary for your platform and installs it to /usr/local/bin.

Package managers

Homebrew (macOS/Linux)

brew install jeffreysprompts/tap/jfp

npm / bun (Node.js)

# Using npm
npm install -g @jeffreysprompts/cli

# Using bun
bun install -g @jeffreysprompts/cli

Manual download

Download pre-built binaries from the GitHub releases page. Available platforms:

• jfp-darwin-arm64 — macOS (Apple Silicon)
• jfp-darwin-x64 — macOS (Intel)
• jfp-linux-x64 — Linux (x86_64)
• jfp-linux-arm64 — Linux (ARM64)
• jfp-windows-x64.exe — Windows

After downloading:

# Make executable (macOS/Linux)
chmod +x jfp-darwin-arm64

# Move to PATH
sudo mv jfp-darwin-arm64 /usr/local/bin/jfp

# Verify installation
jfp --version

Build from source

If you prefer to build from source, you'll need Bun installed:

# Clone the repository
git clone https://github.com/Dicklesworthstone/jeffreysprompts.com.git
cd jeffreysprompts.com

# Build the CLI
bun build --compile ./jfp.ts --outfile jfp

# Install
sudo mv jfp /usr/local/bin/

Authenticate (Pro features)

To access your private vault, premium packs, and Pro-only commands, authenticate with your Premium account:

# Authenticate with device code flow
jfp login

# Verify your session
jfp whoami

# Sync your vault for offline access
jfp sync

The login flow opens your browser to verify a device code. Once confirmed, your CLI session is active for 30 days with automatic refresh.

Shell completion

Enable shell completion for a better experience:

# Bash
jfp completion bash >> ~/.bashrc

# Zsh
jfp completion zsh >> ~/.zshrc

# Fish
jfp completion fish > ~/.config/fish/completions/jfp.fish

Verify installation

jfp --version
# jeffreysprompts-cli v1.0.0

jfp --help
# Shows usage information

Troubleshooting

Command not found

Make sure /usr/local/bin is in your PATH:

echo $PATH | grep -q /usr/local/bin || echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc

Permission denied (macOS)

On macOS, you may need to allow the binary in System Settings → Privacy & Security.

Next steps

• Learn basic CLI usage →