List, Tree and Search

Learn how can you navigate through your prompts.

As your library grows, finding the right prompt becomes critical. Prompt Lockbox provides several powerful tools to discover and navigate your collection.

List all Prompts

The list command is perfect for getting a quick, high-level overview of your entire library. The default view is compact, while the --wide flag provides more detail.

CLI

  # For a compact view
  plb list
  
  # For a more detailed view
  plb list --wide

Python

  from prompt_lockbox import Project
  from rich import print
  
  project = Project()
  
  # The list_prompts() method returns a list of Prompt objects
  all_prompts = project.list_prompts()
  
  for p in all_prompts:
      print(
        f"Name: {p.name}, Version: {p.version}, Status: {p.data.get('status')}"
      )

Search for a Specific Prompt

When your library is large, direct search is the fastest way to find what you need. The default fuzzy search is fast, requires no setup, and intelligently searches names, descriptions, and tags.

Checkout advanced searching methods like Semantic or Fuzzy based at Advanced Search & Discovery.

CLI

# Find any prompt that mentions "joke"
plb search fuzzy "joke"

Python

from prompt_lockbox.api import Project
from rich import print

project = Project()

# The search() method returns a list of result dictionaries
search_results = project.search(query="joke", method="fuzzy")

print(search_results)
# [
#   {'score': 90, 'name': 'joke-generator', ...},
#   ...
# ]

The Organized Tree

If you’ve organized your prompts with namespaces (e.g., namespace: [agents, support]), the tree command visualizes your library in a familiar, folder-like structure. This is the best way to browse prompts by category.

CLI

# Display the hierarchical tree
plb tree

Output:

🥡 Prompt Library
├── 🗂️ agents 
│   └── 🗂️ support
│       └── 📄 customer-support-agent.v1.0.0.yml
├── 🗂️ generators
│   └── 📄 joke-generator.v1.0.0.yml
└── 📄 sql-generator.v1.0.0.yml (No Namespace)

Note

The tree command is purely a CLI visualization tool and does not have a direct SDK equivalent, as the SDK’s list_prompts() method provides the raw data needed to build any custom tree structure programmatically.

Next Steps

You now know the three primary ways to find prompts in your library.

Fetch and Run

Learn how pick up a prompt and test it quickly.