https://github.com/cogflows/promptcode-vscode
PromptCode: The VS Code extension that saves the day when your AI code agent (Cursor, etc.) hits a wall. You're in control—select files, craft precise prompts, and effortlessly apply fixes using your favorite LLM.
https://github.com/cogflows/promptcode-vscode
ai-assistant ai-prompts anthropic code-assistant code-generation cursor llm openai prompt-engineering prompt-management vscode-extension windsurf
Last synced: about 1 month ago
JSON representation
PromptCode: The VS Code extension that saves the day when your AI code agent (Cursor, etc.) hits a wall. You're in control—select files, craft precise prompts, and effortlessly apply fixes using your favorite LLM.
- Host: GitHub
- URL: https://github.com/cogflows/promptcode-vscode
- Owner: cogflows
- License: mit
- Created: 2025-03-25T15:26:58.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-03-25T17:04:12.000Z (10 months ago)
- Last Synced: 2025-03-25T17:40:53.883Z (10 months ago)
- Topics: ai-assistant, ai-prompts, anthropic, code-assistant, code-generation, cursor, llm, openai, prompt-engineering, prompt-management, vscode-extension, windsurf
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=cogflows.promptcode
- Size: 183 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# PromptCode
[](https://opensource.org/licenses/MIT)
[](https://github.com/cogflows/promptcode-vscode/releases/latest)
[](https://github.com/cogflows/promptcode-vscode/releases)
[](https://github.com/cogflows/promptcode-vscode)
[](https://marketplace.visualstudio.com/items?itemName=cogflows.promptcode)
[](https://github.com/cogflows/promptcode-vscode/releases/latest)
> **The ultimate rescue tool when AI code agents hit their limits**
PromptCode is your go-to solution when code agents like Cursor or Windsurf hit a wall. Available as both a powerful [VS Code extension](https://marketplace.visualstudio.com/items?itemName=cogflows.promptcode) and a standalone [CLI tool](https://github.com/cogflows/promptcode-vscode/tree/main/packages/cli#readme), PromptCode supercharges your workflow with improved code-to-AI connections. It seamlessly bridges your codebase with your favorite AI models—including those without direct API access, like GPT-5 or Grok. Pick your file context, craft precise prompt templates, generate AI prompts, and even parse the responses—whether you prefer the rich VS Code interface or the flexibility of the command line.
## Demo Video
Watch this short demo to see PromptCode in action:
[](https://www.youtube.com/watch?v=dUpdSAPklfo)
## Quick Start
Choose your path:
### VS Code Extension
1. Install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=cogflows.promptcode)
2. Open Command Palette (`Cmd/Ctrl+Shift+P`) → "PromptCode: Show"
3. Select files, add instructions, generate prompts
### CLI Tool
```bash
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/cogflows/promptcode-vscode/main/packages/cli/scripts/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/cogflows/promptcode-vscode/main/packages/cli/scripts/install.ps1 | iex
# Quick test
promptcode expert "Explain this code" -f "src/**/*.ts"
```
## Why PromptCode?
When your trusty code agent stumbles, PromptCode steps in as the ultimate rescue tool. Its unique strength lies in bridging the gap between your codebase and AI models, offering a structured, intuitive way to:
- **Select specific files** as context for your prompts
- **Add custom instructions** or use prompt templates for clarity
- **Two ways to work**: Rich VS Code UI or powerful CLI—your choice
- **Work with any AI model**, even those tricky non-API ones
- **Parse and apply AI responses** directly to your code, implement yourself, or paste the response to your AI code agent
No more fumbling with scattered tools or manual context copying—PromptCode keeps it all in one place, right where you code.
## Key Features
### 🔍 Smart Context Selection
- **Intuitive File Picker**: Hand-pick files from your workspace to give your AI the exact context it needs
- **Intelligent Filtering**: Quickly filter relevant files with smart search and .gitignore/.promptcode_ignore support
- **Token Optimization**: See real-time token counts to maximize your context window
### ✏️ Instruction Builder
- **Custom Templates**: Built-in prompt templates for common coding tasks (refactoring, bug fixing, optimization, etc.)
- **@mention System**: Quickly insert templates with our `@` mention system (type @ in the instructions field)
- **Workspace Templates**: Create your own project-specific templates in `.promptcode/prompts`
### 💬 Universal AI Compatibility
- **Copy & Paste**: Works with ANY AI model or assistant - including OpenAI, Anthropic Claude, Google Gemini, and others
- **No API Required**: Use with web interfaces, desktop apps, or private instances
- **Supplement Your Workflow**: Perfect companion to Cursor, Windsurf, GitHub Copilot, and other AI coding tools
### 🔄 Structured Output Processing
- **Code Change Extraction**: Automatically parse code changes from AI responses
- **Smart Code Diff**: Preview changes with side-by-side diffs before applying
- **Bulk Apply**: Apply multiple file changes with a single click
### 🚀 CLI Features
- **Expert Mode**: Direct AI consultation with codebase context
- **Preset Management**: Save and reuse file selection patterns
- **Cost Controls**: Budget caps, dry-run mode, and approval workflows
- **Claude Code Integration**: Custom slash commands for Claude Code (`promptcode cc`)
- **Cursor Integration**: Teach Cursor's AI about your codebase (`promptcode cursor`)
- **Auto-Updates**: Keep CLI current with `promptcode update`
## Supported AI Models
PromptCode supports the latest models from OpenAI (GPT-5.1, O3), Anthropic (Claude 4), Google (Gemini 3), and xAI (Grok 4).
```bash
promptcode expert --models # View all models with pricing
```
## Usage
### VS Code Extension Workflow
1. **Select Files**: Open the PromptCode view and use the file explorer to choose the files you want as context.
2. **Add Instructions**: Switch to the Instructions tab, type @ to pull up prompt templates, or write custom directions.
3. **Generate Prompt**: Review your polished prompt in the Generate Prompt tab—copy it or open it in the editor.
4. **Apply Changes**: Paste the AI's response in the Merge tab to review and apply suggested edits effortlessly.
### CLI Workflow
```bash
# Set up AI agent integrations
promptcode cc # Install Claude Code slash commands
promptcode cursor # Enhance Cursor's AI capabilities
# Create a reusable preset for your API files
promptcode preset create api --from-files "src/api/**/*.ts" "src/models/**/*.ts"
# Get expert consultation with preset context
promptcode expert "How can I optimize these database queries?" --preset api
# Generate a prompt for external use
promptcode generate --preset api --template refactor -o prompt.txt
# Direct file analysis
promptcode expert "Review for security issues" -f "src/auth/*.ts" --model gpt-5
```
## Configuration
Tailor PromptCode to your needs with these options:
- **Ignore Patterns**: Define which files to skip when selecting context (e.g., node_modules/ or .git/).
- **Prompt Folders**: Point to directories housing your custom prompt templates for quick access (e.g., .cursorrule, ai-docs).
## Requirements
### VS Code Extension
- VS Code ≥ 1.96.0
- Windows, macOS, or Linux
### CLI Tool
- macOS (Intel/Apple Silicon), Linux (x64), or Windows (x64)
- Internet connection for AI consultations
- API keys for AI providers (OpenAI, Anthropic, Google, or xAI)
## Installation
Choose the tool that fits your workflow—or use both!
### VS Code Extension
Install from the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=cogflows.promptcode) or search for "PromptCode" in VS Code Extensions.
**Features:**
- Visual file selection with tree view
- Real-time token counting
- Built-in prompt templates
- AI response parsing and diff view
- Settings sync across devices
### CLI Tool
Perfect for terminal workflows, automation, and CI/CD pipelines.
#### Quick Install
```bash
# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/cogflows/promptcode-vscode/main/packages/cli/scripts/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/cogflows/promptcode-vscode/main/packages/cli/scripts/install.ps1 | iex
```
#### Update & Uninstall
```bash
promptcode update # Self-update to latest version
promptcode uninstall # Remove CLI and clean up
```
**Features:**
- Expert Mode: Direct AI consultation with codebase context
- Preset Management: Save and reuse file selection patterns
- Template Support: Apply structured prompts for common tasks
- Multi-Model Support: Works with OpenAI, Anthropic, Google, and xAI models
- Claude Code Integration: Install custom slash commands with `promptcode cc`
- Cursor Integration: Enhance Cursor's AI with `promptcode cursor`
See the [CLI documentation](packages/cli/README.md) for detailed usage, integration setup, and examples.
## Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to get started.
## Telemetry
PromptCode collects anonymous usage data (which features are used and any errors encountered) to improve the extension. This respects VS Code's telemetry settings and can be disabled via `promptcode.enableTelemetry` setting. No personal data, file contents, prompts, or code are ever collected.
## Copyright
© 2025 cogflows. All Rights Reserved.