Introduction to PromptRepo
PromptRepo is a Git for Prompts — a high-performance, version-controlled prompt management system designed to be used as a persistent “sidecar” companion to your development workflow. It features dynamic variable resolution, real-time previews, and sub-100ms full-text search.PromptRepo is optimized for a 400px width layout, making it perfect as a side panel companion to your IDE or Claude Desktop.
What Makes PromptRepo Different?
Unlike simple prompt libraries or note-taking apps, PromptRepo treats prompts as first-class versioned artifacts with:- Immutable version history — Never lose a working prompt again
- Dynamic variable resolution — Use
{{variable}}syntax for reusable templates - Full-text search — Find prompts in milliseconds using PostgreSQL’s tsvector
- Direct AI agent integration — Claude Desktop and any MCP-compatible tool can query your prompts at runtime
- Public sharing — Generate read-only links for collaboration
Key Features
Version Control
Two-table versioning pattern (
prompts + prompt_versions) ensures every edit is preserved. View diffs, restore previous versions, and track changes over time.Variable Resolution
Define reusable prompt templates with
{{variable}} placeholders. Resolve them dynamically in the UI or via the MCP server for AI agents.Full-Text Search
Sub-100ms search powered by PostgreSQL
tsvector. Press Cmd+K anywhere to instantly find prompts by title, description, or content.MCP Integration
Expose your prompts to Claude Desktop, Claude Code, Cursor, or any MCP-compatible AI agent. No copy-paste required — agents query prompts directly.
Public Sharing
Generate secure, read-only sharing links (
/p/[promptId]) for collaboration. Share working prompts with teammates without requiring them to sign up.Collections
Organize prompts into user-owned collections. Group by project, category, or workflow to keep your prompt library structured.
Architecture Highlights
PromptRepo is built for speed, density, and reliability using modern web technologies:- Next.js 15 — App Router, Server Actions, React Server Components
- Supabase — PostgreSQL with Row-Level Security (RLS) and SSR-compatible auth
- Tailwind CSS 4 + shadcn/ui — Kanagawa theme optimized for readability
- Vitest + React Testing Library — Comprehensive test coverage
prompt_versions row and updates the HEAD pointer atomically. History is append-only and never deleted.
Who Should Use PromptRepo?
AI Engineers
Build and maintain a personal prompt library with version control. Test variations, track what works, and reuse proven templates across projects.
Teams
Share prompts via public links or MCP servers. Collaborate on prompt engineering without duplicating work or losing context.
Researchers
Document prompt experiments with version notes. Compare diffs between iterations and maintain reproducible prompt chains.
Agent Developers
Integrate PromptRepo’s MCP server into your AI agents. Let agents query, search, and resolve prompts dynamically at runtime.
Use Cases
Prompt Template Library
Store reusable prompt templates with variables like{{language}}, {{framework}}, or {{task}}. Resolve them on-demand in the UI or via API.
Version-Controlled Experiments
Track prompt iterations with version notes. Compare diffs to understand what changed between v1 and v10 of a critical system prompt.AI Agent Memory
Expose your prompts to Claude Desktop or Cursor via the MCP server. Agents canlist_prompts, search_prompts, and resolve_prompt without leaving their workflow.
Team Collaboration
Generate public sharing links for read-only access. Share a working prompt with a colleague or client without requiring them to create an account.Getting Started
Quickstart
Get from zero to your first working prompt in under 5 minutes.
Installation
Set up PromptRepo for local development with Supabase and Next.js.