{"id":29583733,"url":"https://github.com/galfrevn/promptboost","last_synced_at":"2026-05-10T16:39:15.873Z","repository":{"id":303466899,"uuid":"1015564784","full_name":"galfrevn/promptboost","owner":"galfrevn","description":"🏎️ Fast and flexible CLI tool that enhances your prompts using top LLMs. Designed for developers, analysts, and prompt engineers who want better results—faster. ","archived":false,"fork":false,"pushed_at":"2025-10-20T09:02:50.000Z","size":2584,"stargazers_count":4,"open_issues_count":4,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-26T13:57:48.240Z","etag":null,"topics":["ai","bun","cli","prompt","typescript"],"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/galfrevn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-07-07T17:35:56.000Z","updated_at":"2025-08-24T01:48:03.000Z","dependencies_parsed_at":"2025-07-07T20:58:16.912Z","dependency_job_id":"db9549ac-797c-4d53-82cd-b46ddb67b0f7","html_url":"https://github.com/galfrevn/promptboost","commit_stats":null,"previous_names":["galfrevn/promptboost"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/galfrevn/promptboost","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galfrevn%2Fpromptboost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galfrevn%2Fpromptboost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galfrevn%2Fpromptboost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galfrevn%2Fpromptboost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/galfrevn","download_url":"https://codeload.github.com/galfrevn/promptboost/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galfrevn%2Fpromptboost/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32864082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"ssl_error","status_checked_at":"2026-05-10T13:40:02.145Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["ai","bun","cli","prompt","typescript"],"created_at":"2025-07-19T23:38:28.580Z","updated_at":"2026-05-10T16:39:15.845Z","avatar_url":"https://github.com/galfrevn.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/galfrevn/promptboost/main/public/logo.png\" width=80 alt=\"PromptBoost CLI Demo\" /\u003e\n\n\n\u003e AI-Powered Prompt Enhancement Tool - Intelligent and Extensible\n\n[![github release version](https://img.shields.io/github/v/release/galfrevn/promptboost.svg?include_prereleases)](https://github.com/galfrevn/promptboost/releases/latest) [![npm version](https://img.shields.io/npm/v/promptboost.svg)](https://www.npmjs.com/package/promptboost) [![license](https://img.shields.io/github/license/galfrevn/promptboost.svg)](https://github.com/galfrevn/promptboost/blob/main/LICENSE) [![PRs welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg)](https://github.com/galfrevn/promptboost/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) [![code with hearth by galfrevn](https://img.shields.io/badge/%3C%2F%3E%20with%20%E2%99%A5%20by-galfrevn-ff1414.svg)](https://github.com/galfrevn)\n\n\u003cimg src=\"https://github.com/galfrevn/promptboost/blob/4273fad58e9403fda01d9b3569ef51c877b603ba/public/1.gif\" alt=\"PromptBoost CLI Demo\" /\u003e\n\nA powerful command-line tool that enhances prompts using AI providers to optimize interactions with terminal agents like Claude Code, Gemini CLI, OpenAI Code, and more.\n\n## 📝 Table of Contents\n\n- [Providers](#-providers)\n- [Why PromptBoost CLI?](#-why-promptboost-cli)\n- [Features](#-features)\n- [Examples](#-examples)\n- [Installation](#-installation)\n- [Quick Start](#-quick-start)\n- [Configuration](#-configuration)\n- [Development](#-development)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## 🚀 Providers\n\n### Supported AI Providers\n\n| Name | Description | Models |\n| --- | --- | --- |\n| [`OpenAI`](https://openai.com/) | GPT models including latest GPT-4 variants | `gpt-4o`, `gpt-4o-mini`, `gpt-4-turbo`, `o1`, `o3-mini` |\n| [`Anthropic`](https://www.anthropic.com/) | Claude models with advanced reasoning | `claude-3.5-sonnet`, `claude-3-haiku`, `claude-4-opus` |\n| [`Google`](https://ai.google.dev/) | Gemini models with multimodal capabilities | `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash` |\n| [`xAI Grok`](https://x.ai/) | Grok models with real-time information | `grok-3`, `grok-beta`, `grok-vision-beta` |\n\n### Provider Features\n\n| Feature | OpenAI | Anthropic | Google | xAI Grok |\n| --- | :---: | :---: | :---: | :---: |\n| **Streaming** | ✅ | ✅ | ✅ | ✅ |\n| **Model Validation** | ✅ | ✅ | ✅ | ✅ |\n| **Error Recovery** | ✅ | ✅ | ✅ | ✅ |\n| **Token Counting** | ✅ | ✅ | ✅ | ✅ |\n\n## 🤖 Why PromptBoost CLI?\n\nPromptBoost CLI provides **intelligent prompt enhancement** across multiple AI providers. Whether you're coding, analyzing data, or writing documentation, PromptBoost transforms your simple prompts into comprehensive, context-rich instructions that get better results.\n\n### Intelligent Prompt Enhancement\n\n![prompt-enhancement](https://github.com/galfrevn/promptboost/blob/4273fad58e9403fda01d9b3569ef51c877b603ba/public/2.gif)\n\n**Smart Context Addition**\n\nPromptBoost doesn't just pass your prompts through—it enhances them with:\n\n* **Context Awareness**: Automatically adds relevant context based on your prompt type\n* **Best Practices**: Incorporates proven prompt engineering techniques\n* **Template Integration**: Uses specialized templates for coding, analysis, and general tasks\n* **Format Optimization**: Structures prompts for maximum AI comprehension\n\n### Multi-Provider Intelligence\n\n* **Provider Switching**: Seamlessly switch between OpenAI, Anthropic, Google, and xAI\n* **Model Validation**: Automatic validation of model names and capabilities\n* **Streaming Support**: Real-time response streaming with compatibility checking\n* **Fallback System**: Robust error handling with provider fallbacks\n\n### Developer-Friendly Features\n\n![developer-features](https://github.com/galfrevn/promptboost/blob/4273fad58e9403fda01d9b3569ef51c877b603ba/public/3.gif)\n\n* **File Integration**: Read prompts from files, save enhanced results\n* **Template System**: Built-in templates for common use cases\n* **Configuration Management**: Secure API key storage and provider management\n* **Verbose Logging**: Detailed logging for debugging and optimization\n\n## 🎨 Features\n\n* **Model Validation**: Comprehensive validation of AI models with streaming compatibility checking\n* **Smart Enhancement**: Context-aware prompt improvement using proven techniques\n* **Multi-Provider Support**: Seamless integration with OpenAI, Anthropic, Google, and xAI\n* **Streaming Responses**: Real-time response streaming with progress indicators\n* **Template System**: Built-in templates for coding, analysis, and general use cases\n* **File Operations**: Read from files, save enhanced prompts, batch processing\n* **Configuration Management**: Secure API key storage with environment variable support\n* **Error Recovery**: Robust retry logic with exponential backoff\n* **Beautiful CLI**: Colorized output with progress indicators and clear formatting\n* **Developer Tools**: Verbose logging, testing utilities, and debugging features\n\n![developer-features](https://github.com/galfrevn/promptboost/blob/4273fad58e9403fda01d9b3569ef51c877b603ba/public/4.gif)\n\n## 🐾 Examples\n\n### Basic Enhancement\n```bash\n# Simple prompt enhancement\npromptboost \"Create a React component\"\n\n# Use specific provider\npromptboost \"Fix my code\" --provider anthropic\n```\n\n### Advanced Usage\n```bash\n# Streaming with verbose output\npromptboost \"Explain quantum computing\" --stream --verbose\n\n# File operations\npromptboost --file prompt.txt --output enhanced.txt\n\n# Configuration and testing\npromptboost config set --provider openai --key sk-your-key\npromptboost test --provider anthropic\n```\n\n### Model Validation\n```bash\n# Set valid model (auto-validated)\npromptboost config set --provider openai --model gpt-4o-mini\n✓ Configuration updated for provider: openai\n\n# Try invalid model (caught by validation)\npromptboost config set --provider openai --model invalid-model\n✗ Invalid model configuration:\n  • Model 'invalid-model' is not valid for provider 'openai'\n  • Valid models for openai: gpt-4o, gpt-4o-mini, gpt-4-turbo...\n```\n\n## 📦 Installation\n\n### NPM (Recommended)\n```bash\nnpm install -g promptboost\n```\n\n### From Source\n```bash\n# Clone the repository\ngit clone https://github.com/galfrevn/promptboost.git\ncd promptboost\n\n# Install dependencies\nbun install\n\n# Build and link\nbun run build\nnpm link\n```\n\n### Prerequisites\n- [Node.js](https://nodejs.org/) 18+ or [Bun](https://bun.sh)\n- API keys for at least one supported provider\n\n## 🚀 Quick Start\n\n### 1. Install PromptBoost\n```bash\nnpm install -g promptboost\n```\n\n### 2. Configure a Provider\n```bash\n# OpenAI (recommended for beginners)\npromptboost config set --provider openai --key sk-your-openai-key\n\n# Anthropic (great for coding)\npromptboost config set --provider anthropic --key ant-your-anthropic-key\n\n# Google (multimodal capabilities)\npromptboost config set --provider google --key AIza-your-google-key\n\n# xAI Grok (real-time information)\npromptboost config set --provider grok --key xai-your-grok-key\n```\n\n### 3. Enhance Your First Prompt\n```bash\npromptboost \"Create a simple web scraper in Python\"\n```\n\n### 4. Explore Advanced Features\n```bash\n# Use streaming for real-time responses\npromptboost \"Explain machine learning\" --stream\n\n# Save results to file\npromptboost \"Write API documentation\" --output docs.md\n```\n\n## 🔑 Configuration\n\n### Method 1: CLI Configuration (Recommended)\n\n```bash\n# Configure providers with automatic validation\npromptboost config set --provider openai --key sk-your-openai-key\npromptboost config set --provider anthropic --key ant-your-anthropic-key\npromptboost config set --provider google --key AIza-your-google-key\npromptboost config set --provider grok --key xai-your-grok-key\n\n# Set specific models (with validation)\npromptboost config set --provider openai --model gpt-4o-mini\npromptboost config set --provider anthropic --model claude-3-5-sonnet-20241022\n\n# Set default provider\npromptboost config set --default openai\n\n# View configuration\npromptboost config show\n```\n\n### Method 2: Environment Variables\n\n```bash\nexport PROMPTBOOST_OPENAI_KEY=\"sk-your-openai-key\"\nexport PROMPTBOOST_ANTHROPIC_KEY=\"ant-your-anthropic-key\"\nexport PROMPTBOOST_GOOGLE_KEY=\"AIza-your-google-key\"\nexport PROMPTBOOST_GROK_KEY=\"xai-your-grok-key\"\nexport PROMPTBOOST_DEFAULT_PROVIDER=\"openai\"\n```\n\n### Method 3: Configuration File\n\nConfiguration is stored in `~/.promptboost/config.json`:\n\n```json\n{\n  \"version\": \"1.0.0\",\n  \"defaultProvider\": \"openai\",\n  \"providers\": {\n    \"openai\": {\n      \"name\": \"openai\",\n      \"apiKey\": \"sk-your-key-here\",\n      \"model\": \"gpt-4o-mini\",\n      \"baseUrl\": \"https://api.openai.com/v1\",\n      \"enabled\": true\n    },\n    \"anthropic\": {\n      \"name\": \"anthropic\",\n      \"apiKey\": \"ant-your-key-here\",\n      \"model\": \"claude-3-5-sonnet-20241022\",\n      \"baseUrl\": \"https://api.anthropic.com\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Model Validation\n\nPromptBoost automatically validates model names and streaming compatibility:\n\n```bash\n# ✅ Valid model names are accepted\npromptboost config set --provider openai --model gpt-4o-mini\n✓ Configuration updated for provider: openai\n\n# ❌ Invalid models are rejected with helpful suggestions\npromptboost config set --provider openai --model gpt-5\n✗ Invalid model configuration:\n  • Model 'gpt-5' is not valid for provider 'openai'\n  • Valid models for openai: gpt-4o, gpt-4o-mini, gpt-4-turbo...\n\n# ⚠️ Special models show warnings\npromptboost config set --provider openai --model o1-mini\n⚠️ Note: o1-mini is a reasoning model with longer response times.\n✓ Configuration updated for provider: openai\n```\n\n## 🔧 Development\n\n### Project Structure\n\n```\npromptboost/\n├── src/\n│   ├── commands/              # CLI command implementations\n│   │   ├── enhance.ts         # Main enhancement command\n│   │   ├── config.ts          # Configuration management\n│   │   └── test.ts            # Provider testing\n│   ├── providers/             # AI provider implementations\n│   │   ├── base.ts            # Abstract base provider\n│   │   ├── openai.ts          # OpenAI integration\n│   │   ├── anthropic.ts       # Anthropic Claude integration\n│   │   ├── grok.ts            # xAI Grok integration\n│   │   └── google.ts          # Google Gemini integration\n│   ├── utils/                 # Utility modules\n│   │   ├── config.ts          # Configuration management\n│   │   ├── logger.ts          # Logging utility\n│   │   ├── validation.ts      # Input validation\n│   │   └── model-validation.ts # AI model validation\n│   ├── types/                 # TypeScript type definitions\n│   │   └── index.ts           # All interface definitions\n│   └── index.ts               # Main CLI entry point\n├── examples/                  # Usage examples\n└── tests/                     # Test files\n```\n\n### Setup\n\nFork `main` branch into your personal repository. Clone it to local computer. Install node modules. Before starting development, you should check if there are any errors.\n\n```bash\n$ git clone https://github.com/{your-personal-repo}/promptboost.git\n$ cd promptboost\n$ bun install\n$ bun run build\n$ bun run test\n```\n\n### Development Commands\n\n```bash\n# Start development mode\nbun run dev\n\n# Type checking\nbun run typecheck\n\n# Linting and formatting\nbun run lint\n\n# Build for production\nbun run build\n\n# Run tests\nbun run test\n```\n\n### Code Style\n\nThis project uses [Biome](https://biomejs.dev/) for linting and formatting:\n\n- **Indentation**: 2 spaces\n- **Quotes**: Single quotes for JavaScript, double for JSON\n- **Semicolons**: Always required\n- **Line width**: 100 characters\n\n### Adding New Providers\n\nTo add a new AI provider:\n\n1. **Create Provider Class**:\n   ```typescript\n   // src/providers/newprovider.ts\n   export class NewProvider extends BaseProvider {\n     async enhance(request: EnhanceRequest): Promise\u003cEnhanceResponse\u003e {\n       // Implementation\n     }\n   }\n   ```\n\n2. **Update Provider Factory**:\n   ```typescript\n   // src/providers/index.ts\n   case 'newprovider':\n     return new NewProvider(provider);\n   ```\n\n3. **Add Model Validation**:\n   ```typescript\n   // src/utils/model-validation.ts\n   newprovider: {\n     'model-name': { streaming: true },\n     // ... other models\n   }\n   ```\n\n### Testing\n\n```bash\n# Test all providers\nbun run test\n\n# Test specific functionality\npromptboost test --provider openai --verbose\n\n# Manual testing workflow\npromptboost config set --provider openai --key test-key\npromptboost \"test prompt\" --verbose\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/amazing-feature`\n3. Make your changes\n4. Run tests: `bun run test`\n5. Run linting: `bun run lint`\n6. Commit changes: `git commit -m 'Add amazing feature'`\n7. Push to branch: `git push origin feature/amazing-feature`\n8. Open a Pull Request\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Bun](https://bun.sh) - Fast JavaScript runtime\n- [Commander.js](https://github.com/tj/commander.js) - CLI framework\n- [Biome](https://biomejs.dev/) - Linting and formatting\n- [Picocolors](https://github.com/alexeyraspopov/picocolors) - Terminal colors\n\n---\n\n**Built with ❤️ using TypeScript and Bun**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalfrevn%2Fpromptboost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgalfrevn%2Fpromptboost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalfrevn%2Fpromptboost/lists"}