mark my prompt (codename: promptean) - VS Code Extension
Sync your favorite AI prompts and coding rules with mark my prompt directly from VS Code and Cursor.
Features
🚀 Sync Selected Text
- Right-click any selected text and sync it as a prompt or rule
- Automatic tagging with customizable default tags
- Smart categorization based on content type
🤖 ChatGPT & Codex Integration
- Official OpenAI Codex support - Direct integration with OpenAI's Codex extension
- ChatGPT extension support - Works with popular ChatGPT extensions
- Automatic detection of installed AI coding assistants
- One-click sync from chat conversations
- Smart prompt extraction from chat interfaces
📚 Browse Your Library
- Prompts Explorer - Browse and organize your AI prompts
- Rules Explorer - Manage your coding rules and guidelines
- Tag-based grouping for easy navigation
- Search functionality to find content quickly
⚡ Quick Insert
- One-click insertion of prompts and rules into your code
- Hover tooltips showing content preview
- Context-aware placement at cursor position
🔄 Auto-Sync
- Background synchronization with configurable intervals
- Startup sync to keep your library up-to-date
- Real-time updates when content changes
⚙️ Flexible Configuration
- Custom API endpoints for self-hosted mark my prompt instances
- Secure API key storage with VS Code's secret storage
- Notification preferences and sync settings
- Default tags for new content
Installation
From VS Code Marketplace
- Open VS Code or Cursor
- Go to Extensions (Ctrl+Shift+X)
- Search for "mark my prompt Sync"
- Click Install
Manual Installation
- Download the
.vsix file from releases
- Open VS Code/Cursor
- Run
Extensions: Install from VSIX... command
- Select the downloaded file
Quick Start
# Open Command Palette (Ctrl+Shift+P)
> mark my prompt: Configure mark my prompt
Enter your:
- API URL:
https://api-backend-us01.markmyprompt.com (or your mark my prompt server)
- API Key: Your mark my prompt authentication key
2. Sync Your First Prompt
- Select any text in your editor
- Right-click and choose "Sync Selected Text as Prompt"
- Enter a title and tags
- Your prompt is now synced to mark my prompt!
3. Browse Your Library
- Open the Explorer panel
- Find "mark my prompt Prompts" and "mark my prompt Rules" sections
- Click any item to insert it at your cursor
Usage Examples
# Always use type hints for function parameters and return values
def calculate_total(items: List[Item]) -> float:
return sum(item.price for item in items)
Select the comment → Right-click → "Sync Selected Text as Rule"
Syncing AI Prompts
Explain this code step by step, focusing on the algorithm's time complexity and potential optimizations.
Select the text → Right-click → "Sync Selected Text as Prompt"
Syncing from OpenAI Codex (Official)
- Install the official OpenAI Codex extension from the VS Code Marketplace (extension IDs:
openai.codex or legacy openai.chatgpt)
- Open Codex panel in VS Code (usually on the right side)
- Have a conversation with Codex
- Select your prompt text in the Codex chat
- Use Command Palette:
Ctrl+Shift+P → "mark my prompt: Sync from OpenAI Codex"
- Or use: "mark my prompt: Sync Selected Text from Codex" for selected text
Syncing from Other ChatGPT Extensions
- Install a ChatGPT extension (e.g., ChatGPT by gencay, ChatGPT Helper, etc.)
- Open a ChatGPT chat window
- Select text from your prompt in the chat
- Use Command Palette:
Ctrl+Shift+P → "mark my prompt: Sync from ChatGPT"
- Or look for sync buttons automatically added to chat messages
Supported Extensions
- OpenAI Codex (
openai.codex or legacy openai.chatgpt) - Official OpenAI extension ⭐
- ChatGPT by gencay (
gencay.vscode-chatgpt)
- ChatGPT Helper (
kiranshah.chatgpt-helper)
- ChatGPT VSCode Plugin (
butler.chatgpt-vscode-plugin)
- And other popular ChatGPT extensions
Commands
| Command |
Description |
Shortcut |
mark my prompt: Sync Selected Text as Prompt |
Sync selection as AI prompt |
- |
mark my prompt: Sync Selected Text as Rule |
Sync selection as coding rule |
- |
mark my prompt: Sync from ChatGPT |
Sync prompt from ChatGPT chat |
- |
mark my prompt: Sync from OpenAI Codex |
Sync prompt from Codex panel |
- |
mark my prompt: Sync Selected Text from Codex |
Sync selected text from Codex |
- |
mark my prompt: Sync Clipboard as Prompt |
Sync clipboard contents (helpful for Codex webviews) |
Ctrl+Alt+Shift+P / Cmd+Alt+Shift+P |
mark my prompt: Sync Copilot Clipboard as Prompt |
Sync clipboard contents from Copilot chat |
Ctrl+Alt+Shift+C / Cmd+Alt+Shift+C |
mark my prompt: Enable ChatGPT Integration |
Enable ChatGPT extension integration |
- |
mark my prompt: Configure mark my prompt |
Open configuration dialog |
- |
Configuration
Settings
Access via File → Preferences → Settings → Extensions → mark my prompt
| Setting |
Default |
Description |
promptean.apiUrl |
https://api-backend-us01.markmyprompt.com |
mark my prompt API base URL |
promptean.apiKey |
"" |
Your mark my prompt API key |
promptean.autoSync |
false |
Auto-sync on startup |
promptean.syncInterval |
300 |
Auto-sync interval (seconds) |
promptean.showNotifications |
true |
Show sync notifications |
promptean.defaultTags |
["vscode"] |
Default tags for new content |
Example Configuration
{
"promptean.apiUrl": "https://api.markmyprompt.com",
"promptean.apiKey": "your-secret-key",
"promptean.autoSync": true,
"promptean.syncInterval": 600,
"promptean.defaultTags": ["vscode", "coding", "ai"]
}
Integration with mark my prompt Backend
This extension works with the mark my prompt backend API. Make sure your backend supports:
POST /api/sync/content - Sync new content
GET /api/prompts - List prompts/rules
GET /api/prompts/:id - Get specific content
GET /api/search - Search content
GET /api/health - Health check
{
"title": "My Prompt",
"content": "Explain this code...",
"type": "prompt",
"tags": ["vscode", "ai"],
"source": "vscode-extension",
"timestamp": "2024-01-01T00:00:00.000Z"
}
Troubleshooting
Connection Issues
- Check API URL: Ensure your mark my prompt server is running
- Verify API Key: Make sure your key has proper permissions
- Network: Check firewall and proxy settings
Sync Problems
- Refresh manually: Use refresh commands in explorer
- Check logs: Open Developer Tools (Help → Toggle Developer Tools)
- Restart extension: Reload VS Code window
Common Error Messages
| Error |
Solution |
| "Invalid API key" |
Check your API key in settings |
| "Cannot connect to API" |
Verify API URL and network connection |
| "No text selected" |
Select text before syncing |
| "Failed to load prompts" |
Check API connection and refresh |
Development
Building from Source
# Clone repository
git clone https://github.com/markmyprompt/vscode-extension.git
cd vscode-extension
# Install dependencies
npm install
# Compile TypeScript
npm run compile
# Package extension
vsce package
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
Changelog
v1.0.0
- Initial release
- Basic sync functionality
- Tree view explorers
- Configuration management
- Auto-sync capabilities
Support
License
MIT License - see LICENSE file for details.
Made with ❤️ for the AI-powered development community