This project is still in development. Installation and settings are not convenient yet.

A fast, minimal CLI tool for managing and accessing your AI prompt library. prompt-manager-cli lets you organize, search, and reuse prompts efficiently with fuzzy search and interactive selection.

As a frequent user of Obsidian, I wanted a seamless way to manage my personal prompt files directly within my knowledge base. With the growing popularity of terminal-based AI tools like codex-cli, gemini-cli, and claude-code, I saw an opportunity to bridge the gap between modern prompt engineering and efficient, text-based workflows.

This project was created to make it easy to organize, access, and use prompts from text-files, while leveraging the power and flexibility of the command line. My goal is to help users streamline their workflow, keep their prompts well-organized, and take advantage of the latest AI tools—all from a familiar environment.

• 🔍 Fuzzy Search - Quickly find prompts with intelligent fuzzy matching
• 🎯 Interactive Selection - Beautiful TUI for browsing and selecting prompts
• 📋 Multiple Commands - Flexible CLI with pick, search, ls, cat, and mesh commands
• ⚙️ Configurable - Customize file extensions, directories, and search limits via settings.toml
• 📁 Multi-Directory Support - Load prompts from multiple directories
• 📋 Clipboard Integration - Copy selected prompts directly to clipboard
• 🚀 Fast & Lightweight - Single binary, no dependencies to install

Make sure you have Go 1.24+ installed.

git clone https://github.com/hzionn/prompt-manager-cli.git
cd prompt-manager-cli
go build ./cmd/pm

This will produce a pm binary in the current directory.

Then point the prompt directory to your desired directory in settings.toml. Multiple directories are supported.

# Make it globally accessible (optional)
sudo mv pm /usr/local/bin/pm

# Verify installation
pm --help

Launch the interactive prompt picker:

pm

Or pick a prompt by query without interaction:

pm "code review"
pm --query "code review"

Find prompts matching a query and display matches:

pm search "code review"
pm search --limit 5 "code"

Use --interactive flag to launch the picker after search:

pm search --interactive "code"

Show all available prompts:

pm ls

Display a specific prompt by name:

pm cat "code review"

Combine multiple prompts together:

pm mesh "prompt1" "prompt2"

You can also pipe additional content:

pm mesh "system-prompt" "context-prompt" < user-input.txt

• --dir <paths> - Override default prompt directories (comma-separated)
• --query <query> - Provide a query for non-interactive selection
• --copy - Copy the chosen prompt to clipboard
• --interactive - Force interactive selection mode

# Pick a prompt interactively
pm

# Search for prompts about "testing"
pm search testing

# Get a specific prompt by name
pm cat "code-review"

# Search with a limit and use interactive picker
pm search --limit 10 --interactive "review"

# Copy a prompt to clipboard
pm --query "code review" --copy

# Use prompts from custom directories
pm --dir "/path/to/prompts,~/my-prompts" search "api"

# Combine multiple prompts
pm mesh "system-prompt" "user-prompt" | pbcopy

prompt-manager-cli reads configuration from config/settings.toml. Create or modify this file to customize behavior:

# Default directories where prompts are stored
default_dir = ["./prompts"]

# Cache directory for temporary data
cache_dir = "./.pm-cache"

# File system settings
[file_system]
# File extensions to look for when scanning directories
extensions = [".md", ".txt"]

# Patterns to ignore when scanning
ignore_patterns = [".DS_Store"]

# Maximum file size to load (in KB)
max_file_size_kb = 128

# Fuzzy search configuration
[fuzzy_search]
# Maximum number of search results to return
max_results = 20

# UI configuration
[ui]
# Maximum length to truncate prompt display
truncate_length = 120

prompt-manager-cli/
├── cmd/pm/
│   └── main.go              # CLI entrypoint
├── internal/
│   ├── clipboard/           # Clipboard operations
│   ├── config/              # Configuration loading
│   ├── prompt/              # Prompt loading and management
│   ├── search/              # Fuzzy search implementation
│   └── ui/                  # Interactive TUI
├── config/
│   └── settings.toml        # Default configuration
├── prompts/                 # Example prompts
├── testdata/                # Test fixtures
├── go.mod                   # Go module definition
└── README.md                # This file

# Build the binary
go build ./cmd/pm

# Run tests
go test ./...

# Format code
find . -name '*.go' | xargs gofmt -w

# Run tests with coverage
go test -cover ./...

# Run a specific test
go test -run TestName ./...

# Format code
find . -name '*.go' | xargs gofmt -w

Organize your prompts in directories with appropriate file extensions:

prompts/
├── code-review.md
├── brainstorm.txt
├── product-brief.md
└── stock_researcher.md

Prompt files can be in Markdown (.md) or text (.txt) format. The filename (without extension) becomes the prompt's name for selection.

# Code Review Checklist

- Verify naming conventions
- Ensure tests cover critical paths
- Confirm error handling
- Check for edge cases

• Prompt tags and metadata
• Better UIUX
• Expose to package managers
• Color schemes and themes
• Batch operations on multiple prompts
• Plugin system for custom search strategies

Found a bug or have a feature request? Please open an issue.