Leave inline feedback comments on any file in VS Code. Your AI coding agent sees them automatically as diagnostics and knows how to resolve them.
Search "Agent Notes" in the VS Code Extensions panel, or install via CLI:
code --install-extension AbdallahGamal.agent-notes- Select text in any file
- Right-click → Add Feedback, or press
Ctrl+Alt+F(Cmd+Alt+Fon Mac) - Type your comment and press Enter
The selected text gets highlighted and a comment thread appears in the gutter.
- Inline — comment threads appear directly in the editor
- Feedback Panel — Explorer sidebar → Feedback, grouped by file
- Problems Panel — each comment shows as an Information diagnostic with source "Agent Notes"
Click the reply button in any comment thread to add a reply.
Click Resolve Thread on a comment to mark it as addressed. The comment, highlight, and diagnostic all disappear.
Feedback survives code edits. When lines are inserted or deleted above a comment, the range shifts automatically. If the anchored text is heavily modified, the comment is marked as orphaned (dimmed with ⚠).
Every feedback comment is published as a VS Code diagnostic. AI agents that read the Problems panel see your feedback automatically — including the comment body, author, selected text, all replies, and instructions on how to resolve it.
[Feedback] reviewer (1/15/2026): Consider error handling here
On: "function validateToken()"
---
[Reply] developer (1/15/2026): Good point, will fix
[Resolve] After addressing this feedback, resolve it by removing the thread object
with "id": "a1b2c3d4-..." from the "threads" array in .vscode/agent-notes.json
The AI reads the feedback, addresses it in code, then edits the JSON file to resolve it. The extension detects the change and clears everything automatically.
Add the following to your project's AI instruction file so the agent checks for feedback before completing tasks.
Claude Code — add to CLAUDE.md:
## Agent Notes
This project uses the Agent Notes extension for code review comments.
Feedback appears as Information-severity diagnostics with source "Agent Notes" in the Problems panel.
Before considering any task complete:
1. Check diagnostics for any "Agent Notes" items related to your changes
2. Address the feedback described in each diagnostic message
3. Resolve addressed feedback by removing its thread object from .vscode/agent-notes.json
(match by the "id" field shown in the diagnostic message)GitHub Copilot — add to .github/copilot-instructions.md:
## Agent Notes
This project uses inline feedback comments via the Agent Notes extension.
Check the Problems panel for diagnostics with source "Agent Notes" before completing tasks.
Each diagnostic contains the feedback context and resolve instructions in its message.
To resolve: remove the matching thread by "id" from .vscode/agent-notes.json.Cursor — add to .cursorrules:
This project uses the Agent Notes extension for code review comments.
Check diagnostics with source "Agent Notes" in the Problems panel before completing tasks.
Each diagnostic message includes feedback context and resolve instructions.
To resolve feedback: remove the thread object by "id" from .vscode/agent-notes.json.
| Action | Windows/Linux | Mac |
|---|---|---|
| Add Feedback | Ctrl+Alt+F |
Cmd+Alt+F |
Feedback is stored in .vscode/agent-notes.json, gitignored automatically. The file stays local to your workspace.