Prompt Manager

A standalone system for managing AI prompts with composable elements.

Overview

Prompt Manager provides a web interface and API for creating, organizing, and managing prompts for AI interactions. It supports composable templates, prompt directories, and real-time editing. There is a focus on keyboard shortcuts and efficient workflow- directory listing and prompt embedding support tab completion, most interactions can be navigated using keyboard shortcuts, etc.

Features

• Create and manage prompts (standard and composite)
• Compose templates with prompt inclusions and expansions
• Real-time editing via WebSocket (for prompts)
• Access prompts via RESTful API
• Render templates with all inclusions expanded
• Organize prompts in directories
• Integrates with Model Context Protocol (MCP) for advanced prompt workflows

Quick Start

1. Clone the repository:

   git clone <repository-url>
   cd prompt_manager
   

2. Set up the environment (choose one):

   # Using Taskfile (recommended for full dev setup)
   task setup:py
   task setup:js
   task setup:e2e
   # Or using Makefile
   make setup
   

3. Run the application:

   ./bin/start_prompt_manager.sh
   # Or
   bin/restart_prompt_manager.sh
   

4. Open your browser to http://localhost:8081

Usage

The prompt manager can be used in two ways:

1. Web Interface: Access the web UI at http://localhost:8081
2. API: Use the RESTful API endpoints to programmatically manage prompts

API Endpoints

Prompt Management

• GET /api/prompts/all: List all prompts
• GET /api/prompts/{prompt_id}: Get a specific prompt
• POST /api/prompts: Create a new prompt
• PUT /api/prompts/{prompt_id}: Update a prompt
• DELETE /api/prompts/{prompt_id}: Delete a prompt
• POST /api/prompts/expand: Render a template with inclusions expanded
• POST /api/prompts/rename: Rename a prompt

Directory Management

• GET /api/prompts/directories/all: List all prompt directories
• POST /api/prompts/directories: Add a new directory
• DELETE /api/prompts/directories/{directory_path}: Remove a directory
• POST /api/prompts/reload: Reload all prompts from all directories

WebSocket Interface

• Connect to /api/prompts/ws/{prompt_id} for real-time prompt editing
• Uses standard WebSocket protocol with JSON messages for updates

Configuration

The system uses several directories for prompt storage:

• Project data directory: prompt_manager/data/prompts/
• User config directory: ~/.prompt_manager/prompts/

MCP Integration

Prompt Manager supports integration with the Model Context Protocol (MCP) for advanced prompt workflows and Claude Desktop compatibility. See mcp_server/ and related scripts for details.

Development & Testing

• Run tests with pytest or using the provided Taskfile/Makefile targets.
• See CHANGES.md for recent updates and protocol fixes.
• See README.md in mcp_server/ for MCP-specific details.

License

Apache License 2.0. See LICENSE.