{"id":49172587,"url":"https://github.com/pedrofuentes/gitnotate","last_synced_at":"2026-04-22T20:03:19.896Z","repository":{"id":347471700,"uuid":"1194147441","full_name":"pedrofuentes/gitnotate","owner":"pedrofuentes","description":"Sub-line commenting for Markdown files in GitHub PR reviews.","archived":false,"fork":false,"pushed_at":"2026-04-08T07:10:23.000Z","size":1195,"stargazers_count":0,"open_issues_count":30,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-08T07:24:50.988Z","etag":null,"topics":["collaboration","comments","git","github","pull-requests"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pedrofuentes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-28T01:20:11.000Z","updated_at":"2026-04-08T06:23:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pedrofuentes/gitnotate","commit_stats":null,"previous_names":["pedrofuentes/gitnotate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pedrofuentes/gitnotate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrofuentes%2Fgitnotate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrofuentes%2Fgitnotate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrofuentes%2Fgitnotate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrofuentes%2Fgitnotate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pedrofuentes","download_url":"https://codeload.github.com/pedrofuentes/gitnotate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pedrofuentes%2Fgitnotate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32152608,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["collaboration","comments","git","github","pull-requests"],"created_at":"2026-04-22T20:03:16.245Z","updated_at":"2026-04-22T20:03:19.878Z","avatar_url":"https://github.com/pedrofuentes.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gitnotate\n\n\u003e **git + annotate** — Sub-line commenting for Markdown files in GitHub PR reviews.\n\n[![CI](https://github.com/pedrofuentes/gitnotate/actions/workflows/ci.yml/badge.svg)](https://github.com/pedrofuentes/gitnotate/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-10B981.svg)](./LICENSE)\n[![Version](https://img.shields.io/badge/version-0.1.0-10B981.svg)](./CHANGELOG.md)\n\nGitnotate lets you comment on specific words and phrases within a line — not just the whole line — directly in GitHub Pull Request reviews. It ships as a **Chrome/Edge browser extension** and a **VSCode extension**, both enhancing GitHub's native commenting with sub-line precision.\n\n## The Problem\n\nGitHub PR reviews only support line-level comments. When reviewing Markdown documents (specs, proposals, plans), you often want to comment on a specific phrase like \"revenue growth exceeded expectations\" — not the entire line. Word and Google Docs do this well; GitHub doesn't.\n\n## How It Works\n\nGitnotate uses a lightweight approach: it embeds sub-line metadata directly in standard GitHub PR comments. This means:\n\n- **Works without the extension** — comments show a quoted text fallback, fully readable by anyone\n- **Zero extra files** — no sidecar files or infrastructure needed\n- **All GitHub features** — threading, resolve, @mentions, reactions, notifications work out of the box\n\nSee [ROADMAP.md](./ROADMAP.md) for the full architecture, research, and implementation plan.\n\n## Installation\n\n### VS Code Marketplace\n1. Search \"Gitnotate\" in the Extensions view (`Ctrl+Shift+X`) or visit the [VS Code Marketplace page](https://marketplace.visualstudio.com/items?itemName=pedrofuentes.gitnotate)\n2. Click **Install**\n3. Open a repo with an active PR — sign in to GitHub when prompted\n4. Select text in a Markdown file and right-click → **Gitnotate: Add Comment**\n\n### Chrome Web Store\n1. Visit the [Gitnotate page on Chrome Web Store](https://chrome.google.com/webstore/detail/agfdgeojcagbmadfffiiccgfhgmakngp)\n2. Click **Add to Chrome**\n\n### Edge Add-ons\n1. Visit the [Gitnotate page on Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/gitnotate/nkbdpjplkeeoncbdelkfneinclinnemp)\n2. Click **Get** to install\n\n### Install from GitHub Release\n1. Download `gitnotate-v0.1.0.zip` from the [latest release](https://github.com/pedrofuentes/gitnotate/releases/latest)\n2. Extract the zip to a folder on your computer\n3. Open `chrome://extensions` (or `edge://extensions`)\n4. Enable **\"Developer mode\"** (toggle in the top-right corner)\n5. Click **\"Load unpacked\"** → select the extracted folder\n6. The Gitnotate icon should appear in your toolbar\n\n\u003e **Note:** Manually installed extensions show a \"Developer mode\" warning on browser startup. Installing from the store removes this.\n\nTo update: download the new zip, extract to the same folder, then click the reload ↻ button on the extension card.\n\n### Install from Source\n1. Clone the repo: `git clone https://github.com/pedrofuentes/gitnotate.git`\n2. Install dependencies: `pnpm install`\n3. Build: `pnpm build`\n4. Open `chrome://extensions` (or `edge://extensions`)\n5. Enable \"Developer mode\"\n6. Click \"Load unpacked\" → select `packages/browser-extension/dist/`\n\n### Setup\n1. Click the Gitnotate icon in your toolbar\n2. Visit any PR → click \"Enable\" on the opt-in banner\n3. Select text in a diff to start commenting\n\n## VSCode Extension\n\nThe VSCode extension brings sub-line commenting directly into your editor for GitHub PR reviews.\n\n### Key Capabilities\n- **Sub-line comment threads** — native VSCode comment threads anchored to exact character ranges in PR diffs\n- **Comments sidebar** — all PR comments grouped by file with click-to-navigate\n- **Reply \u0026 resolve** — full threading and resolution via GitHub's review API\n- **Live polling** — auto-refresh comments via ETag-based conditional requests (configurable interval)\n- **Side-aware diffs** — comments placed on the correct side (old/new) in diff views\n- **Diff-aware anchoring** — comment threads follow text through local edits\n\n### Install\nSearch \"Gitnotate\" in VSCode's Extensions view or install from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=pedrofuentes.gitnotate).\n\n### Setup\n1. Open a repository with an active PR\n2. Sign in to GitHub when prompted (uses VSCode's built-in GitHub auth)\n3. Open a Markdown file from the PR — comment threads appear automatically\n4. Select text and right-click → \"Gitnotate: Add Comment\" to post a sub-line comment\n\n## Status\n\n🚀 **v0.1.0** — Browser extension for Chrome/Edge and VSCode extension — all live.\n\n## License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedrofuentes%2Fgitnotate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpedrofuentes%2Fgitnotate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpedrofuentes%2Fgitnotate/lists"}