Code Comment

PR-style comment threads on any file in VS Code, persisted in a plain .annotations.json at the workspace root, with AI agents as participants.

Select lines, leave a comment, reply, resolve. Agents (Claude Code, Cursor, etc.) read and edit .annotations.json directly — the same way a teammate would on a PR.

Features

• Gutter click to comment — hover the gutter, click +, type an inline comment.
• Threaded conversations — root comment + replies, resolve closes (and deletes) the whole thread.
• .annotations.json — plain JSON at the workspace root, gitignored, watched live for external (agent) edits.
• Copy All Comments — Code Comment: Copy All Comments copies every thread to the clipboard, then clears them.

Data format

Agents read and write .annotations.json directly. The full schema and editing rules are documented in the repo at docs/annotations-schema.md.

{
  "version": 1,
  "threads": [
    {
      "id": "a3f9c2d4e5",
      "file": "src/extension.ts",
      "startLine": 12,
      "endLine": 14,
      "comments": [
        { "id": "b1c2d3e4f5", "author": "franco", "body": "Mira esto", "createdAt": "2026-08-27T23:00:00.000Z" }
      ]
    }
  ]
}

Only open threads live in the file — resolving a thread deletes it.

Configuration

• codeComment.author — name your comments are signed with (agents sign agent:...). Default: user.

Development

npm install
npm run compile   # bundle with esbuild

Run the extension host with F5, or code --extensionDevelopmentPath=. .