{"id":29966730,"url":"https://github.com/rfbigelow/prompt-manager","last_synced_at":"2026-04-17T12:33:49.937Z","repository":{"id":303278097,"uuid":"1005819808","full_name":"rfbigelow/prompt-manager","owner":"rfbigelow","description":"A Deno app for managing versioned prompts, created in collaboration with Claude Code","archived":false,"fork":false,"pushed_at":"2025-07-06T18:17:01.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-04T03:29:05.988Z","etag":null,"topics":["claude-code","deno","prompt-engineering"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rfbigelow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T22:06:24.000Z","updated_at":"2025-07-06T18:17:05.000Z","dependencies_parsed_at":"2025-07-06T19:32:08.223Z","dependency_job_id":"cdff3089-240b-41bc-b6f1-d222f0be1f26","html_url":"https://github.com/rfbigelow/prompt-manager","commit_stats":null,"previous_names":["rfbigelow/prompt-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rfbigelow/prompt-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfbigelow%2Fprompt-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfbigelow%2Fprompt-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfbigelow%2Fprompt-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfbigelow%2Fprompt-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rfbigelow","download_url":"https://codeload.github.com/rfbigelow/prompt-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rfbigelow%2Fprompt-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31929797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T10:35:34.458Z","status":"ssl_error","status_checked_at":"2026-04-17T10:35:09.472Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","deno","prompt-engineering"],"created_at":"2025-08-04T03:01:21.654Z","updated_at":"2026-04-17T12:33:49.899Z","avatar_url":"https://github.com/rfbigelow.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prompt Manager\n\nA command-line tool for managing and versioning AI prompts with full version history, comparison, and reversion capabilities.\n\n## Features\n\n- 📝 **Version Control** - Every prompt edit creates a new version\n- 🔄 **Comparison** - Compare different versions to see what changed\n- ⏪ **Reversion** - Revert to any previous version\n- 🏷️ **Tagging** - Organize prompts with tags\n- 📝 **Change Descriptions** - Document what changed in each version\n- 📁 **File-based Storage** - Simple, portable JSON storage\n- 🎨 **Clean CLI** - Intuitive command-line interface with colored output\n\n## Requirements\n\n- [Deno](https://deno.land/) 2.3.0 or higher\n\n## Installation\n\n### Clone and Build\n\n```bash\ngit clone https://github.com/rfbigelow/prompt-manager.git\ncd prompt-manager\n\n# Build executable\ndeno task build\n\n# The executable will be in dist/prompt-manager\n```\n\n### Run from Source\n\n```bash\n# Run directly without building\ndeno task start \u003ccommand\u003e [options]\n\n# Or use the dev mode with file watching\ndeno task dev \u003ccommand\u003e [options]\n```\n\n## Usage\n\n### Create a New Prompt\n\n```bash\n# Create from file\nprompt-manager create -n \"API Request Template\" -f templates/api-request.txt\n\n# Create with a custom change description\nprompt-manager create -n \"API Request Template\" -f templates/api-request.txt -m \"Initial API request template for v2 endpoints\"\n\n# Example output:\n# ✓ Prompt created successfully\n# ID: 550e8400-e29b-41d4-a716-446655440000\n# Name: API Request Template\n# Version: 1\n```\n\n### Update an Existing Prompt\n\n```bash\n# Update creates a new version\nprompt-manager update 550e8400-e29b-41d4-a716-446655440000 -f templates/api-request-v2.txt\n\n# Update with a change description\nprompt-manager update 550e8400-e29b-41d4-a716-446655440000 -f templates/api-request-v2.txt -m \"Added error handling and retry logic\"\n\n# Example output:\n# ✓ Prompt updated successfully\n# Version: 2\n```\n\n### View a Prompt\n\n```bash\n# Basic view\nprompt-manager get 550e8400-e29b-41d4-a716-446655440000\n\n# View with version history\nprompt-manager get 550e8400-e29b-41d4-a716-446655440000 --verbose\n```\n\n### List All Prompts\n\n```bash\nprompt-manager list\n\n# Example output:\n# Prompts:\n#   550e8400-e29b-41d4-a716-446655440000 - API Request Template (updated: 2024-01-20T10:30:00)\n#   660f9500-f39c-52e5-b827-557766550111 - Code Review Guidelines (updated: 2024-01-19T15:45:00)\n```\n\n### View Version History\n\n```bash\nprompt-manager versions 550e8400-e29b-41d4-a716-446655440000\n\n# Example output:\n# Versions:\n#   v1 - 2024-01-20T10:00:00 (Initial version)\n#     ID: 770g0611-g40d-63f6-c938-668877661222\n#   v2 - 2024-01-20T10:30:00 (Added error handling and retry logic)\n#     ID: 880h1722-h51e-74g7-d049-779988772333\n```\n\n### Compare Versions\n\n```bash\n# Compare using version numbers (recommended)\nprompt-manager compare 550e8400-e29b-41d4-a716-446655440000 v1 v2\n\n# Or mix version numbers and IDs\nprompt-manager compare 550e8400-e29b-41d4-a716-446655440000 v1 880h1722-h51e-74g7-d049-779988772333\n\n# Example output:\n# Comparing v1 → v2\n#\n# Modified:\n# ~ Line 5: \"Make a GET request\" → \"Make a GET request with error handling\"\n#\n# Added:\n# + Line 10: Handle network errors gracefully\n# + Line 11: Retry failed requests up to 3 times\n```\n\n### Revert to Previous Version\n\n```bash\n# Revert using version number (recommended)\nprompt-manager revert 550e8400-e29b-41d4-a716-446655440000 v1\n\n# Or using version ID\nprompt-manager revert 550e8400-e29b-41d4-a716-446655440000 770g0611-g40d-63f6-c938-668877661222\n\n# Example output:\n# ✓ Reverted successfully\n# New version: 4\n```\n\n## Data Storage\n\nPrompts are stored in your home directory under `~/.prompt-manager/`:\n\n```\n~/.prompt-manager/\n├── prompts/\n│   ├── 550e8400-e29b-41d4-a716-446655440000.json\n│   └── 660f9500-f39c-52e5-b827-557766550111.json\n└── versions/\n    ├── 550e8400-e29b-41d4-a716-446655440000/\n    │   ├── v1.json\n    │   ├── v2.json\n    │   └── v3.json\n    └── 660f9500-f39c-52e5-b827-557766550111/\n        └── v1.json\n```\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/rfbigelow/prompt-manager.git\ncd prompt-manager\n```\n\n### Available Tasks\n\n```bash\n# Development mode with file watching\ndeno task dev\n\n# Run tests\ndeno task test\n\n# Run tests with coverage\ndeno task test:coverage\n\n# Run tests in watch mode\ndeno task test:watch\n\n# Lint code\ndeno task lint\n\n# Format code\ndeno task fmt\n\n# Type check\ndeno task check\n\n# Build executable\ndeno task build\n```\n\n### Project Structure\n\n```\nprompt-manager/\n├── src/\n│   ├── main.ts           # Entry point\n│   ├── models/\n│   │   └── prompt.ts     # Data models\n│   ├── services/\n│   │   ├── cli.ts        # CLI interface\n│   │   ├── prompt-manager.ts  # Business logic\n│   │   └── storage.ts    # File storage\n│   └── types/\n│       └── cli.ts        # TypeScript types\n├── tests/                # Test files\n├── deno.json            # Deno configuration\n└── README.md\n```\n\n### Running Tests\n\n```bash\n# Run all tests\ndeno task test\n\n# Run with coverage report\ndeno task test:coverage\n\n# Coverage report will be in coverage/html/index.html\n```\n\n## Architecture Decisions\n\n- **File-based Storage**: Uses JSON files for simplicity and portability\n- **Version Numbering**: Sequential integers for human readability\n- **UUID Identifiers**: Ensures unique IDs across systems\n- **Separate Version Files**: Each version stored independently for easy access\n\n## Project Status\n\nThis is a case study project created to demonstrate working with Claude Code. It's a fully functional tool but is not actively seeking contributions.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Author\n\nRobert F. Bigelow Jr.\n\n## Acknowledgments\n\n- Built with [Deno](https://deno.land/)\n- Uses Deno's standard library for core functionality\n- Developed in collaboration with [Claude Code](https://claude.ai/code) as a case study in AI-assisted development\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frfbigelow%2Fprompt-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frfbigelow%2Fprompt-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frfbigelow%2Fprompt-manager/lists"}