Skip to content

skylerwww/noter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

noter

A Chrome/Chromium extension for annotating UI elements. Hover to highlight, click to select, capture a screenshot of the element, write a note, then export as Markdown (for AI) or HTML (with screenshots) for review. Screenshot 2026-05-16 at 6 48 11 PM


Install

  1. Open Chrome and go to chrome://extensions
  2. Enable Developer mode (top-right toggle)
  3. Click Load unpacked
  4. Select the folder that contains manifest.json at its top level.
    • If you used Download ZIP from GitHub, pick the inner folder (usually noter-main/), not the parent zip folder.
  5. Reload the extension after updates (chrome://extensions → Reload on the noter card).
  6. On any tab you want to annotate, refresh the page once after installing or updating.

The extension icon will appear in your toolbar.

Troubleshooting

Symptom Fix
“Cannot connect to this page” Refresh the tab. If you just installed noter, the tab must reload so the content script can attach.
Toggle does nothing Same as above — refresh. Open a normal https:// page (not chrome://, New Tab, or the Web Store).
Works locally but not from GitHub ZIP Load unpacked must point at the folder with manifest.json, not noter-main.zip or a parent directory.
file:// pages On chrome://extensions → noter → Details, enable Allow access to file URLs.

How to use

Step Action
1 Click the extension icon in the toolbar
2 Turn Noting on (toggle in the popup)
3 Hover over the page — elements highlight in orange
4 Click an element to capture a screenshot and open the note dialog
5 Write your note, then press Save Note (or ⌘↵ / Ctrl↵)
6 A numbered orange badge appears on the annotated element
7 Repeat for as many elements as needed
8 Open the popup → copy Markdown or download HTML for a saved session

Press Esc at any time to stop noting without losing saved notes.


Export formats

Markdown (.md)

Text-first document for pasting into an AI chat. Includes selector, element context, and notes (no embedded screenshots).

# noter tasks

## Task 1 — `button.save-btn`

**Fix:** Button label should say "Save changes", not "Save".

**Element context:** `<button>` · 120×40px · "Save"

HTML (.html)

Self-contained page with inline screenshots. Open in any browser for human review — best for sharing with designers or PMs.

Download from the popup (document icon). Each task shows the fix request, element context, and a cropped screenshot.


Notes

  • Screenshots capture only the visible viewport at the time of click. Scroll the element into view before annotating for best results.
  • Annotations are stored in-page memory only — refreshing the page clears them. Export before refreshing.
  • The extension does not work on chrome:// or edge:// internal pages (browser restriction).
  • Device pixel ratio is accounted for on Retina/HiDPI displays.

About

Chrome extension: highlight UI elements, add notes, export for AI agents

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors