Annotative is a lightweight VS Code extension for code annotation and team collaboration. Highlight code, add tagged notes with custom colors, and export to Markdown for sharing with your team or AI tools like Copilot, ChatGPT, and Claude. Perfect for code reviews, documenting issues, and collaborative feedback.
- Review code systematically - Flag issues, improvements, and observations as you code
- Team collaboration - Share annotations with teammates for synchronized feedback
- AI-assisted development - Export annotations to discuss with Copilot, ChatGPT, or Claude
- Documentation - Capture insights and create self-documenting code reviews
- Issue tracking - Mark, prioritize, and track code issues within the editor
- Knowledge sharing - Create project-specific annotation libraries for team learning
- Select code you want to annotate
- Press Ctrl+Shift+A or right-click and select "Add Annotation"
- Enter your note
- Add tags to categorize (bug, performance, security, etc.)
- Choose a color for visual preference
- View in sidebar with flexible organization options
- Export as Markdown or share with your team
- Fast annotation - Keyboard shortcuts and context menus for quick feedback
- Visual highlighting - See annotated code directly in your editor with color coding
- Smart organization - Group annotations by file, tag, project, or status
- Flexible tagging - Built-in tags (bug, performance, security, docs, etc.) plus custom tag support
- Resolution tracking - Mark annotations resolved when issues are addressed
- Easy export - Generate Markdown for sharing, documentation, or AI discussions
- Persistent storage - Auto-save annotations between sessions
- Zero configuration - Works out of the box with no setup needed
- Project-based storage - Save annotations in
.annotative/folder within your project for team sharing - Custom tags - Create, edit, and delete tags tailored to your team's workflow
- Sidebar editing - Update annotation comments directly from the sidebar
- Multiple organization modes - Group by file, tag, project, or resolution status
- Bulk operations - Tag, resolve, or delete multiple annotations at once
- Smart filtering - Filter by status, tag, or search across all annotations
- Keyboard navigation - Jump between annotations with Alt+Up/Down
- Undo support - Quickly undo the last annotation
- Copilot integration - Use @annotative participant in Copilot Chat for AI discussion
- Multi-format export - Optimized exports for Copilot, ChatGPT, Claude, or generic sharing
| Shortcut | Action |
|---|---|
Ctrl+Shift+A (Mac: Cmd+Shift+A) |
Add annotation to selected text |
Ctrl+Shift+Z (Mac: Cmd+Shift+Z) |
Undo last annotation |
Alt+Down |
Jump to next annotation |
Alt+Up |
Jump to previous annotation |
Ctrl+Shift+F (Mac: Cmd+Shift+F) |
Search annotations |
Ctrl+Alt+E (Mac: Cmd+Alt+E) |
Export annotations |
Export your annotations and paste directly into ChatGPT, Copilot Chat, or Claude to:
- Discuss issues and get suggestions
- Request code improvements
- Generate documentation
- Iterate on AI-generated code
Use the @annotative participant in Copilot Chat to:
- Get AI suggestions on all annotations in a file
- Ask Copilot about specific annotations
- Generate fixes for flagged issues
Use the command palette (Ctrl+Shift+P / Cmd+Shift+P) to access:
| Command | Description |
|---|---|
| Add Annotation | Annotate selected code |
| Edit Annotation | Update comment in sidebar |
| Toggle Resolved | Mark annotation resolved/unresolved |
| Remove Annotation | Delete an annotation |
| Filter by Status | Show all, open, or resolved only |
| Filter by Tag | Focus on specific tag categories |
| Create Custom Tag | Define custom tags for your team |
| Edit Custom Tag | Modify custom tag properties |
| Delete Custom Tag | Remove a custom tag |
| List All Tags | View all available tags |
| Initialize Project Storage | Create .annotative/ folder for team sharing |
| Show Storage Info | View where annotations are stored |
| Export Annotations | Copy as Markdown to clipboard |
| Search Annotations | Find annotations across workspace |
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X/Cmd+Shift+X) - Search for "Annotative"
- Click Install
After installation:
- Select any code in your editor
- Press
Ctrl+Shift+Aor right-click and select "Add Annotation" - Enter your note and choose a color
- (Optional) Add tags to categorize the annotation
- View all annotations in the Annotative sidebar
- Export annotations to share
- VS Code 1.105.0 or higher
- No additional dependencies - works out of the box!
Want to contribute or test locally?
Quick Start:
- Clone the repository
- Run
npm install - Press F5 in VS Code to launch the extension
- Test in the Extension Development Host window
See CONTRIBUTING.md for detailed setup instructions.
Annotations are stored per workspace in .annotative/ folder:
- Project-specific: Each project can have its own annotation set in
.annotative/annotations.json - Shared with team: Commit
.annotative/to version control to share annotations with teammates - Portable: Take your workspace and annotations with you
- Auto-save: Changes save automatically during development
- Global fallback: If no project storage exists, annotations save globally in VS Code's storage
- Initialize project storage - Run
Annotative: Initialize Project Storageto create.annotative/folder - Establish consistent tags - Create custom tags your team agrees on (e.g., "security-review", "needs-clarification")
- Version control - Commit
.annotative/to share annotations with teammates - Code review workflow - Use annotations as a lightweight alternative to traditional PR comments
- Create tags - Use
Annotative: Create Custom Tagto define project-specific categories - Assign priorities - Tags support low, medium, high, and critical priority levels
- Use colors strategically - Align tag colors with severity or category (red = critical, blue = documentation)
- Bulk operations - Apply the same tag to multiple annotations for organization
- Export annotations and paste directly into Copilot Chat, ChatGPT, or Claude
- Use
@annotativeparticipant in Copilot Chat for direct integration - Ask AI to prioritize issues or suggest fixes based on tagged annotations
- Iterate on AI suggestions and track progress with resolved status
- Use "Group by Tag" to see all similar issues together
- Use "Group by Status" to focus on unresolved items first
- Use "Filter by Tag" to focus on specific categories
- Use bulk operations to efficiently manage large annotation sets
Annotative is fully open source and available under the MIT License.
- Free for personal, educational, commercial, and enterprise use
- Modify and distribute freely
- No restrictions on commercial use
See LICENSE for details.
New Features:
- Project-based storage - Initialize
.annotative/folder to store annotations in your project - Sidebar editing - Edit annotation comments directly from the sidebar with dedicated edit button
- Custom tags CRUD - Create, edit, and delete custom tags tailored to your team's workflow
- Enhanced tag management - All preset and custom tags available in tag picker
Commands:
Annotative: Initialize Project Storage- Set up project-specific annotation storageAnnotative: Create Custom Tag- Define new tags with custom colors and prioritiesAnnotative: Edit Custom Tag- Modify existing custom tagsAnnotative: Delete Custom Tag- Remove custom tags (preset tags protected)Annotative: List All Tags- View all available tagsAnnotative: Show Storage Info- Check current storage location
- Performance improvements and bug fixes
- Enhanced sidebar rendering
- Improved tag handling
- 8-color picker for visual annotation preference
- Lightweight input boxes instead of complex webviews
- Native VS Code UI components
- Full MIT open source license
See CHANGELOG.md for complete version history.
- GitHub Issues - Report bugs and request features
- GitHub Discussions - Share ideas and best practices
- Documentation - See docs/ folder for detailed guides
Built by developers for developers who care about code quality.
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}