The jfp CLI includes powerful search capabilities with fuzzy matching and filtering.

Basic search

Search for prompts by keyword:

# Search all fields
jfp search "code review"

# Search returns matches from title, description, and content
jfp search debugging

Fuzzy search

jfp uses fuzzy matching, so you don't need exact matches:

# Finds "idea-wizard" even with typos
jfp search "idee wizrd"

# Partial matches work
jfp search "refact"

Interactive browser (fzf-style)

For an interactive experience similar to fzf:

# Launch interactive browser
jfp i

In interactive mode:

Type to filter results in real-time
Use arrow keys to navigate
Press Enter to view a prompt
Choose actions like copy, install, or export
Press Esc to cancel

Search scopes (Pro)

Pro search scopes require logging in with a Pro subscription. The CLI itself is free to build and use with public prompts.

# Search your personal prompts
jfp search "review" --mine

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

# Search everything (public + personal)
jfp search "review" --all

# Force local registry only
jfp search "review" --local

For exact category or tag filtering, use jfp list --category or jfp list --tag.

Limiting output

# Show only top 5 results
jfp search "debugging" --limit 5

# Show first result only
jfp search "debugging" --limit 1

Recommendations

Use recommend to discover prompts based on your saved library or to get related suggestions for a specific prompt.

# Personalized recommendations (uses saved prompts when available)
jfp recommend

# Related prompts for a specific ID
jfp recommend idea-wizard

# JSON output
jfp recommend --json

JSON output for scripting

Use --json for programmatic access:

# Get JSON results
jfp search "automation" --json

# Pipe to jq for filtering
jfp search "robot" --json | jq '.results[0].id'

# Get just the IDs
jfp search "robot" --json | jq -r '.results[].id'

Search tips

Queries are keyword-based. Use multiple words to narrow results:

# Multi-word query
jfp search "code review"

# Short query still works
jfp search automation

Combining with other commands

# Search then show the first result
jfp show "$(jfp search "wizard" --json | jq -r '.results[0].id')"

# Search and copy first result to clipboard
jfp show "$(jfp search "review" --json | jq -r '.results[0].id')" --raw | pbcopy

# Export all search results
jfp search "debugging" --json | jq -r '.results[].id' | xargs jfp export --format md

Registry cache

jfp uses a local prompt registry cache for fast searches:

# Force refresh the cache
jfp refresh

# View cache status
jfp status

Impact analysis

When you need to understand downstream usage, the CLI can show prompt dependencies and export the full graph. Use metadata flags to expand the graph with categories, tags, or your collections.

# Show downstream dependencies
jfp impact idea-wizard

# Export dependency graph as JSON
jfp graph export --json

# Include category/tag nodes
jfp graph export --include-meta --json

# Include collection nodes (requires login)
jfp graph export --include-collections --json

Examples

Find prompts for a specific task

# Find code review prompts
jfp search "code review"

# Browse debugging prompts by category
jfp list --category debugging

Build a prompt toolkit

# Find all prompts for a project type
jfp search "testing" --json > my-testing-prompts.json

# Export as Markdown
jfp search "robot mode" --json | jq -r '.results[].id' | xargs jfp export --format md

Search Commands