Show HN: Sightmap – Runtime context for agents using your web app

Sightmap, an open YAML format and CLI stewarded by Fullstory's Subtext team, provides runtime context for AI agents by maintaining a shared memory of a web app's views, components, and API requests. The project includes a specification, a Go reference implementation, and agent skills for tools like Claude Code and Cursor, enabling agents to curate and read the same map against a live browser.

Sightmap is an open YAML format and CLI that maintain a shared memory of a web app for AI agents. A .sightmap/ directory in your repo names the app's views , components , and API requests ; any definition can carry a memory list — freeform notes about quirks, invariants, and shortcuts the source code doesn't record. Agents curate the map against the running app with the sightmap CLI, definitions link back to their source files, and every agent that works on the app reads the same map. → sightmap.org — overview and landing page → — full documentation → docs.sightmap.org https://docs.sightmap.org — the canonical specification → /sightmap/sightmap/blob/main/spec spec/ — the reference implementation Go library + /sightmap/sightmap/blob/main/go go/ sightmap CLI This is the home of the open Sightmap project. It holds the spec, the reference implementation, and both websites in one place: | Path | What it is | |---|---| spec/ | normative specification — spec/v1/ schema + JSON Schema, the SEP process spec/seps/ , and language-agnostic conformance fixtures. Source of truth. go/ Go implementation — the sightmap CLI live browser capture, annotated snapshots, coverage plus a go get -able library for the component model and selector matching. Published to npm as . https://www.npmjs.com/package/@sightmap/sightmap @sightmap/sightmap skills/ agent skills — sightmap-authoring and sightmap-browser . This is the canonical, standalone skills directory; the CLI embeds a committed copy under go/skills/ regenerated via go generate . docs/ docs.sightmap.org https://docs.sightmap.org Mintlify . web/ sightmap.org https://sightmap.org React + Vite .Each area has its own README with build and contribution details. The sightmap CLI is published to npm. Install it globally: npm install -g @sightmap/sightmap sightmap version Or run it without installing: npx @sightmap/sightmap <command . Building from source Go is covered in go/ /sightmap/sightmap/blob/main/go . Install the CLI above , then drop a .sightmap/ directory at your project root. Every .yaml / .yml file under it is discovered recursively and merged. .sightmap/home.yaml version: 1 views: - name: FlightSearch route: /search components: - name: DepartureDatePicker selector: ' data-picker="departure" ' memory: - Accepts typed YYYY-MM-DD — skips the calendar Then point your agent at the directory. The quickstart https://docs.sightmap.org/start/quickstart walks the full loop, and the sightmap CLI /sightmap/sightmap/blob/main/go drives curation against a live browser. The skills/ /sightmap/sightmap/blob/main/skills directory is a first-class, installable skill set for coding agents — sightmap-authoring build and maintain a corpus and sightmap-browser drive a live session . It reaches agents three ways, all from the same source: As a plugin — install this repo like any other Claude Code: /plugin marketplace add sightmap/sightmap then /plugin install sightmap@sightmap-marketplace . Useful on its own as a browser-use agent, no other tooling required. Via the CLI — sightmap skills install extracts the embedded copy into ~/.agents/skills/ handy when you already have the binary . Vendored by downstream tools — they ship in the publishednpm package, so consumers like @sightmap/sightmap Subtext https://subtext.fullstory.com pull them from a pinned version. Your coding agents — Claude Code, Cursor, Codex, Windsurf, and anything else that reads repo files.— runtime enrichment for live browser sessions and session replays; snapshots and network traces get semantic names, memory guides, and source paths injected automatically. Subtext https://subtext.fullstory.com Sightmap is open source and stewarded by the Subtext https://subtext.fullstory.com team at Fullstory. We welcome contributions from anyone. - Start with CONTRIBUTING.md - Proposing a spec change? See spec/seps/README.md - Reporting security issues: SECURITY.md - Who maintains this: MAINTAINERS.md MIT — see LICENSE /sightmap/sightmap/blob/main/LICENSE .