Skip to main content

Search Commands

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 (premium)

# 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

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 skill

Registry cache

jfp uses a local prompt registry cache for fast searches:

# Force refresh the cache
jfp refresh

# View cache status
jfp status

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 Skills for Claude Code
jfp search "robot mode" --json | jq -r '.results[].id' | xargs jfp export --format skill

Related