PromptHive 🐝
Professional prompt manager for developers. Terminal-native, sub-80ms operations, works with any AI tool.
TL;DR
# Install (Latest: v0.1.8)
# OR: curl -sSL https://prompthive.sh/install.sh | bash
# Multiple Workflows - Choose Your Style
# 1. Perfect commit messages (PRODUCTION READY ✅)
|
# 2. Instant debugging (BATTLE TESTED ✅)
| |
# 3. Complete PR workflows
| | |
Why? Because copy-pasting from ChatGPT history takes 30+ seconds. PromptHive takes 45ms.
Current Version: 0.1.8 - Production ready with professional registry, magic link authentication, team collaboration, and viral sharing
🚀 Philosophy: Terminal-First Development | Spec-Driven AI Engineering
📁 Documentation: See README.md for complete usage guide
Core Promise: Every command under 80ms. It's a TOOL, not a LIBRARY.
Unix Philosophy: We don't run AI. We manage prompts perfectly, and pipe them to ANY AI tool you prefer. Like
npmdoesn't run JavaScript, we don't run prompts. We just make them instantly accessible.
# PromptHive + Your Favorite AI Tools - Three Patterns:
# 1. Command Substitution (Interactive AI):
# 2. Piped with -p flag (Non-interactive/Scripting):
| | |
| |
# 3. Direct Output (Auto-clipboard):
🚀 Installation
Cargo (Rust) - Available Now ✅
# Install from crates.io
# Verify installation
Quick Install Script
# Automatic installation with platform detection
|
# Verify installation
Current Status: Version 0.1.8 is available on crates.io. The install script automatically downloads pre-built binaries for your platform.
Shell Completions
After installation, set up shell completions for the best experience:
Bash
Zsh
# Add to ~/.zshrc: fpath=(~/.zsh_completions $fpath)
Fish
Quickstart
# Use built-in essentials (ready to go!)
| | |
# Use immediately with real workflows
| | | |
# Use with ANY AI tool (copies to clipboard if terminal, pipes if piped)
| | | | | | | | |
# Lightning-fast operations
# Share with the world
"But Why Not Just..."
...use text files?
- Can't fuzzy search across them in 50ms
- No smart matching (ph u au → auth-basic)
- No metadata or descriptions
- No sharing/versioning/teams
...use shell aliases?
# This gets unwieldy fast:
# vs
...use ChatGPT/Claude history?
- Takes 30+ seconds to search and copy
- Lost between browser tabs
- Can't pipe or compose
- No version control
...use GitHub Gists?
- Network latency (2-5 seconds minimum)
- No offline access
- Requires browser
- Can't pipe directly
See this README for complete documentation.
Commands (v0.1.8)
# Just run 'ph' to launch the TUI (like lazygit)
### Advanced Features
🚀 Power User Examples
Template Variables - Supercharge Your Prompts
# Built-in variables make prompts dynamic
# Set custom variables for your workflow
# Use them in any prompt
|
# Output: "Feature for PromptHive v2.0 by backend team\n\nOAuth implementation"
# Environment variables work too
Version Control - Never Lose a Good Prompt
# Tag important versions of your prompts
# View history
# 📚 Version history for 'api-design'
# 📌 v2.0 (a3b4c5d6) - Complete rewrite for REST best practices
# 📌 v1.1 (87654321) - Added error handling section
# 📌 v1.0 (12345678) - Initial stable API prompt
# Rollback when needed
# ✅ Rolled back 'api-design' to version 'v1.1'
Batch Operations - Manage Prompt Libraries
# Add tags to multiple prompts
# Clean up old prompts
# Export prompt collections
Diff & Merge - Collaborate on Prompts
# Compare prompt versions
# Merge improvements
Web Dashboard - Visual Analytics
# Open interactive dashboard
Command History - Track Your Usage
# See what you've been using
🎯 Unified I/O Design - Smart Defaults
PromptHive uses intelligent defaults based on context, reducing typing while maintaining flexibility:
Text Transformation Commands (use, show, clean)
In Terminal (TTY):
- Auto-copies to clipboard by default
- No stdout output (content is on clipboard)
- Use
-qto suppress clipboard and output to stdout instead
When Piping:
- Outputs to stdout for pipe compatibility
- No auto-clipboard (use
-cto force clipboard)
# Terminal usage - auto-clipboard
# Piping - outputs to stdout
| | |
# Force clipboard even when piping
|
# Quiet mode in terminal
Query Commands (ls, find)
Always outputs to stdout (auto-clipboard would be too noisy)
- Use
-cto explicitly copy results - Use
-sto save as a new prompt
Universal I/O Flags
Every command supports these consistent flags:
-s NAME- Save output as a new prompt-a NAME- Append output to existing prompt-c- Force copy to clipboard-f PATH- Write to file (with bidirectional sync)-q- Quiet mode (suppress default behaviors)-e- Edit before output (where applicable)
Smart File Operations
The -f flag creates bidirectional sync by default:
# Create prompt with automatic file sync
# Smart naming when path not provided
# Bidirectional sync means:
# - Edit the file → prompt updates
# - Edit the prompt → file updates
# - Always stay in sync!
Composable Flags
All flags work together sensibly:
# Clean, save, append, copy, and write to file
# Use prompt, edit result, save, and sync to file
# Find prompts, save results, copy to clipboard
Design Philosophy
- Smart defaults: Do the right thing based on context
- Explicit overrides: Flags always override defaults
- Composability: All flags combine logically
- No surprises: Predictable behavior in all contexts
Configuration
Disable Logging
# Temporary (this session only)
# Only errors
# Complete silence
# Permanent (add to ~/.zshrc or ~/.bashrc)
Other Environment Variables
PROMPTHIVE_BASE_DIR=/custom/path # Change storage location
PROMPTHIVE_EDITOR=code # Set preferred editor
PROMPTHIVE_LOG_FORMAT=json # JSON logs for production
Creative Usage Patterns
🎯 Daily Journaling & Reflection
# Create a journal bank
# Daily workflow
🧠 Learning & Study Assistant
# Create study prompts
# Study session
| |
💼 Meeting & Communication Templates
# Professional templates
# Quick usage
|
🎨 Creative Writing & Content
# Writing helpers
# Content creation
| |
🔧 DevOps & Operations
# Runbook templates
# Incident response
📊 Data Analysis & Research
# Analysis templates
# Research workflow
| |
🎮 Personal Productivity
# Life management
# Daily use
🚀 API & Integration Patterns
# Combine with other tools
# Scheduled prompts
# 0 9 * * 1 ph use work/weekly-goals | mail -s "Weekly Goals" me@example.com
# 0 17 * * * git log --since="9am" | ph use journal/daily | ph save today
Performance
PromptHive operations are optimized for instant prompt access:
)
)
&
What these times represent:
- PromptHive operations: File I/O, prompt processing, fuzzy matching (~2-50ms)
- AI processing time: Separate - depends on your AI tool (5-30+ seconds)
- Value proposition: Zero-latency prompt access vs. writing prompts from scratch
The real speed gain: Instead of spending 2-5 minutes crafting the perfect prompt, you get battle-tested prompts instantly.
Partial Matching (Like JJ)
PromptHive uses smart partial matching:
# If unique, uses the match
# If ambiguous, shows options:
) &
)
)
The Magic: Composition
PromptHive is the ONLY tool that lets you chain prompts:
# Fix a bug completely
| \
| \
| \
| \
| \
# Each prompt transforms the previous output
# Total time: 250ms for 5 prompts
Real-World Usage
Daily Developer Workflows
# 🔥 Auto-generate perfect commit messages
| |
# 🐛 Debug errors instantly
| |
|
# 📝 Generate PR descriptions
| |
# 🧪 Create tests from code
| |
# 📚 Document your code
| |
# 🔍 Code review helper
| |
Advanced Workflows
# Chain multiple prompts for complex tasks
| \
| | \
| | \
|
# Morning standup automation
| \
|
# Refactor legacy code
| \
| | \
|
🧙 Workflow Automation Examples
# AI-Powered Git Workflow
# Automated Code Review Pipeline
# Daily Standup Generator
# Smart Documentation Generator
| | \
|
🔰 Shell Pipes Primer (for Terminal Newbies)
The Basics
# The pipe | sends output from one command to another
|
# Redirect > saves output to a file
# Append >> adds to a file without overwriting
# Input < reads from a file
With PromptHive
# Simple: Copy to clipboard (when in terminal)
# Pipe to AI: Send prompt to AI tool
|
# Chain: Multiple operations
| | |
# Save: Capture output
|
# Combine: Mix different sources
|
When to Use What
- No pipe: When you just want to copy a prompt
- Single pipe |: When sending to one AI tool
- Multiple pipes |: When chaining operations
- Redirect >: When saving results
- Cat/Echo: When adding context to prompts
🏦 Prompt Banks - Instant Productivity
Quick Start with Essential Banks
# Option 1: Use pre-installed essentials bank
# Option 2: Create your own banks
# Now use them: ph use team/api-design
Sharing Banks (Unix Way)
# Personal: Share via Git
&&
# Team: Clone shared bank
# Public: Submit PR to community registry
&&
Real Workflows with Banks
# Perfect commits every time
| |
# Debug like a senior
| |
|
# Full code review
| |
# Install a complete workflow
Building PromptHive with Itself
We built PromptHive using PromptHive:
# Bootstrap phase
|
# Every feature after
|
# Test and iterate
|
File Structure
Dead simple, just markdown files:
~/.prompthive/
├── prompts/
│ ├── api.md
│ ├── auth.md
│ └── test.md
├── registry/
│ └── @kentcdodds/
│ └── react/
└── config.toml
Prompt Format
Just markdown with optional frontmatter:
id: api
description: REST API design
Design a REST API with these requirements:
- ---
Why PromptHive?
- Speed: 80ms operations are addictive (GitHub: 30+ seconds)
- Simple: Just like
lsandcat- no learning curve - Universal: Works with ALL AI tools, not locked to one
- Offline: Your prompts work without internet
- Composable: Chain prompts like Unix commands
- Smart I/O: Auto-clipboard, save, append - works how you think
The Dropbox Moment
"You could just use FTP!" they said about Dropbox. But UX is the product. "You could just use text files!" they'll say about PromptHive. But speed is the product.
80ms vs 30 seconds. Every time. That's the difference.
The Vision
In one year:
- Every tutorial starts with
ph install - Teams have standardized on PromptHive
- "Just ph it" is a common phrase
- The registry has 10,000+ quality prompts
Features
Core Features (Production Ready)
- ✅ Lightning-fast prompt management - Create, edit, search, and use prompts
- ✅ Intelligent fuzzy matching -
ph u ap→api-designinstantly - ✅ Universal shell integration - Copy to clipboard or pipe to ANY tool
- ✅ Smart I/O operations - Auto-clipboard, save, append, file output
- ✅ Text cleaning & formatting - AI-style text processing with
ph clean - ✅ Smart completions - Tab completion for bash, zsh, fish
- ✅ Cross-platform - Works on macOS, Linux, Windows
- ✅ Prompt composition - Chain prompts for complex workflows
- ✅ Magic link authentication - Secure login for registry sync
- ✅ Performance guarantee - All operations under 80ms
Pro Features (Available Now)
- ✅ Registry sync - Cloud backup and device sync
- ✅ Magic link authentication - Passwordless secure login
- ✅ Team collaboration - Private prompt banks and sharing
- ✅ Viral sharing - Public and invite-based prompt sharing
- ✅ Community registry - Growing library of quality prompts
- ✅ Usage analytics - Gamified productivity tracking with achievements
- ✅ Web dashboard - Visual prompt management and statistics
Development Build
# Development build (all features)
# Run tests
# Performance benchmark
Troubleshooting
Command not found
# Ensure binary is in PATH
# If using cargo install
|
Clipboard not working
# If terminal, it copies automatically
# Or pipe explicitly
| |
Shell completions not working
# Regenerate completions
🐝 Part of the CalmHive Ecosystem
PromptHive works beautifully with CalmHive CLI - an open-source wrapper for Claude CLI that adds background processing, voice control, and smart defaults.
# Use PromptHive with CalmHive for ultimate productivity
Check out calmhive.com for enhanced Claude CLI workflows!
Performance
PromptHive is engineered for sub-80ms performance across all operations. Built with Rust for maximum efficiency and reliability, it handles thousands of prompts without slowing down your workflow.
Tested on version 0.1.8: All core operations (new, use, show, edit, ls, find) complete in under 80ms on modern hardware.
Join the Hive 🐝
🐝 Free (Open Source)
- Unlimited local prompts
- Lightning-fast performance (<80ms)
- Compose & chain prompts
- Cross-platform support
- Text cleaning & formatting
- Self-hosted everything "Own your productivity stack"
🍯 Pro ($5/month)
- ✅ Magic link authentication
- ✅ Cloud sync across devices
- ✅ Private prompt banks
- ✅ Team collaboration & sharing
- ✅ Viral sharing features
- ✅ Advanced analytics & insights
- 🚀 Priority support (planned) "Supercharge your workflow"
"Prompts that just work."