{"slug": "show-hn-sightmap-runtime-context-for-agents-using-your-web-app", "title": "Show HN: Sightmap – Runtime context for agents using your web app", "summary": "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.", "body_md": "Sightmap is an open YAML format and CLI that maintain a shared memory of a web\napp for AI agents. A `.sightmap/`\n\ndirectory in your repo names the app's\n**views**, **components**, and **API requests**; any definition can carry a\n`memory`\n\nlist — freeform notes about quirks, invariants, and shortcuts the\nsource code doesn't record. Agents curate the map against the running app with\nthe `sightmap`\n\nCLI, definitions link back to their source files, and every\nagent that works on the app reads the same map.\n\n→ ** sightmap.org** — overview and landing page\n→\n\n**— full documentation →**\n\n[docs.sightmap.org](https://docs.sightmap.org)[— the canonical specification →](/sightmap/sightmap/blob/main/spec)\n\n`spec/`\n\n[— the reference implementation (Go library +](/sightmap/sightmap/blob/main/go)\n\n`go/`\n\n`sightmap`\n\nCLI)This is the home of the open Sightmap project. It holds the spec, the reference implementation, and both websites in one place:\n\n| Path | What it is |\n|---|---|\n`spec/` |\n\n**normative** specification —`spec/v1/`\n\nschema + JSON Schema, the SEP process (`spec/seps/`\n\n), and language-agnostic conformance fixtures. Source of truth.`go/`\n\n**Go implementation**— the`sightmap`\n\nCLI (live browser capture, annotated snapshots, coverage) plus a `go get`\n\n-able library for the component model and selector matching. Published to npm as [.](https://www.npmjs.com/package/@sightmap/sightmap)`@sightmap/sightmap`\n\n`skills/`\n\n**agent skills**—`sightmap-authoring`\n\nand `sightmap-browser`\n\n. This is the canonical, standalone skills directory; the CLI embeds a committed copy under `go/skills/`\n\n(regenerated via `go generate`\n\n).`docs/`\n\n[docs.sightmap.org](https://docs.sightmap.org)(Mintlify).`web/`\n\n[sightmap.org](https://sightmap.org)(React + Vite).Each area has its own README with build and contribution details.\n\nThe `sightmap`\n\nCLI is published to npm. Install it globally:\n\n```\nnpm install -g @sightmap/sightmap\nsightmap version\n```\n\nOr run it without installing: `npx @sightmap/sightmap <command>`\n\n. Building from\nsource (Go) is covered in [ go/](/sightmap/sightmap/blob/main/go).\n\nInstall the CLI (above), then drop a `.sightmap/`\n\ndirectory at your project\nroot. Every `*.yaml`\n\n/ `*.yml`\n\nfile under it is discovered recursively and\nmerged.\n\n```\n# .sightmap/home.yaml\nversion: 1\n\nviews:\n  - name: FlightSearch\n    route: /search\n    components:\n      - name: DepartureDatePicker\n        selector: '[data-picker=\"departure\"]'\n        memory:\n          - Accepts typed YYYY-MM-DD — skips the calendar\n```\n\nThen point your agent at the directory. The [quickstart](https://docs.sightmap.org/start/quickstart)\nwalks the full loop, and the [ sightmap CLI](/sightmap/sightmap/blob/main/go) drives curation against a live\nbrowser.\n\nThe [ skills/](/sightmap/sightmap/blob/main/skills) directory is a first-class, installable skill set for\ncoding agents —\n\n`sightmap-authoring`\n\n(build and maintain a corpus) and\n`sightmap-browser`\n\n(drive a live session). It reaches agents three ways, all\nfrom the same source:**As a plugin**— install this repo like any other (Claude Code:`/plugin marketplace add sightmap/sightmap`\n\nthen`/plugin install sightmap@sightmap-marketplace`\n\n). Useful on its own as a browser-use agent, no other tooling required.**Via the CLI**—`sightmap skills install`\n\nextracts the embedded copy into`~/.agents/skills/`\n\n(handy when you already have the binary).**Vendored by downstream tools**— they ship in the publishednpm package, so consumers like`@sightmap/sightmap`\n\n[Subtext](https://subtext.fullstory.com)pull them from a pinned version.\n\n**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)\n\nSightmap is open source and stewarded by the [Subtext](https://subtext.fullstory.com)\nteam at Fullstory. We welcome contributions from anyone.\n\n- Start with\n`CONTRIBUTING.md`\n\n- Proposing a spec change? See\n`spec/seps/README.md`\n\n- Reporting security issues:\n`SECURITY.md`\n\n- Who maintains this:\n`MAINTAINERS.md`\n\nMIT — see [ LICENSE](/sightmap/sightmap/blob/main/LICENSE).", "url": "https://wpnews.pro/news/show-hn-sightmap-runtime-context-for-agents-using-your-web-app", "canonical_source": "https://github.com/sightmap/sightmap", "published_at": "2026-07-29 14:42:42+00:00", "updated_at": "2026-07-29 14:52:54.649856+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools"], "entities": ["Sightmap", "Fullstory", "Subtext", "Claude Code", "Cursor", "Codex", "Windsurf"], "alternates": {"html": "https://wpnews.pro/news/show-hn-sightmap-runtime-context-for-agents-using-your-web-app", "markdown": "https://wpnews.pro/news/show-hn-sightmap-runtime-context-for-agents-using-your-web-app.md", "text": "https://wpnews.pro/news/show-hn-sightmap-runtime-context-for-agents-using-your-web-app.txt", "jsonld": "https://wpnews.pro/news/show-hn-sightmap-runtime-context-for-agents-using-your-web-app.jsonld"}}