Skip to main content

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
  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

Getting a specific prompt

Use the show command with a prompt ID:

# 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

Viewing categories

# List all categories
jfp categories

# Categories include prompt counts by default

Output formats

jfp supports multiple output formats:

  • Default — Human-readable with colors
  • --json — Machine-readable JSON
  • --raw — Just the prompt content, no formatting
  • export --format md — Markdown export
# JSON for scripting
jfp show code-reviewer --json

# Raw prompt for piping
jfp show code-reviewer --raw | pbcopy

# Markdown for documentation
jfp export code-reviewer --format md --stdout > prompt.md

Using with AI coding agents

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

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

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

Common options

OptionDescription
--jsonOutput as JSON
--rawJust the content, no metadata
--category <cat>Filter list by category
--limit <n>Limit results (search/suggest)
JFP_NO_COLOR=1Disable colored output (env var)

Exit codes

jfp uses standard exit codes:

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

Next steps