Basic Usage

The jfp CLI is designed for speed and simplicity. Here are the essential commands.

Quick start

Running jfp with no arguments shows a quick help guide:

$ jfp

JeffreysPrompts CLI - Access battle-tested prompts from your terminal

USAGE:
  jfp [command] [options]

COMMANDS:
  list           List all prompts
  show <id>      Show a specific prompt by ID
  search <query> Search prompts
  recommend      Get prompt recommendations
  impact <id>    Show downstream dependencies
  graph export   Export dependency graph
  categories     List all categories
  export         Export prompts to files
  i              Interactive browser

FLAGS:
  --json         Output as JSON
  --raw          Output raw prompt content
  --help, -h     Show help
  --version, -v  Show version

Listing prompts

# List all prompts
jfp list

# List prompts in a category
jfp list --category debugging

# List with JSON output
jfp list --json

Searching

# Search for prompts
jfp search "code review"

# Search with JSON output
jfp search "debugging" --json --limit 5

Getting a specific prompt

# Get a prompt by ID
jfp show idea-wizard

# Output as JSON
jfp show idea-wizard --json

# Copy directly to clipboard (macOS)
jfp show idea-wizard --raw | pbcopy

Pro commands (requires login)

These commands require a Premium subscription and an authenticated session.

# List your private prompts
jfp list --mine

# Search saved prompts
jfp search "deploy" --saved

# Search all (public + private)
jfp search "deploy" --all

# Save a prompt to your library
jfp save idea-wizard

# Sync your vault for offline access
jfp sync

# Manage notes on prompts
jfp notes add idea-wizard "Great for brainstorming"

# View your collections
jfp collections list

# Install a premium pack
jfp packs install advanced-debugging

# Estimate token cost for a prompt
jfp cost idea-wizard --model claude-opus-4-6

# Suggest tags for a prompt
jfp tags suggest idea-wizard

# Scan for duplicate prompts
jfp dedupe scan --min-score 0.9

Recommendations

# Personalized recommendations
jfp recommend

# Related recommendations for a specific prompt
jfp recommend idea-wizard

Using with AI agents

jfp is optimized for use with AI coding agents like Claude Code:

# Get a prompt and pipe to Claude
jfp show code-reviewer --raw | claude

# Use JSON output for structured parsing
jfp search "debugging" --json --limit 5 | jq -r '.results[0].id'

Output formats

Exit codes

• 0 — Success
• 1 — Error (most failures)
• 130 — User cancelled an interactive prompt

Next steps

• ← Back to installation