# Sightmap

## Docs

- [The Sightmap CLI: A Guided Tour of the Command Surface](https://docs.sightmap.org/authoring/cli.md): Find the right sightmap command for each job — sessions, interaction, capture, coverage, selector tooling, corpus hygiene, and integrations.
- [Authoring a Sightmap: The Edit-Verify Loop with the Sightmap CLI](https://docs.sightmap.org/authoring/overview.md): Build and maintain a .sightmap/ corpus against the running app — iterate, probe, name, and validate until every interactive node is attributed.
- [Sightmap Browser Commands: Managing Chrome Sessions](https://docs.sightmap.org/cli/browser.md): Install Chrome for Testing, start and stop sightmap sessions, navigate, evaluate JavaScript, and reset storage from the command line.
- [Sightmap CLI Capture Commands: snapshot, iterate, and inspect](https://docs.sightmap.org/cli/capture.md): Capture annotated component trees from a live Chrome session: snapshot writes novelty-gated captures, iterate runs the edit-verify loop, and inspect shows the raw DOM for selector authoring.
- [Sightmap CLI: Corpus Health Tools Reference](https://docs.sightmap.org/cli/corpus.md): Complete reference for the sightmap corpus tools: validate, lint, search, and discover — structural checks, style rules, offline YAML search, and URL pattern discovery.
- [Sightmap CLI Coverage Commands: coverage, multi-coverage, and report](https://docs.sightmap.org/cli/coverage.md): Score saved captures offline against your corpus: coverage checks T1/T2/T3 tiers over a view's view set, multi-coverage builds the cross-page matrix, and report rolls up per-view health.
- [Sightmap CLI: Integration Tools Reference](https://docs.sightmap.org/cli/integrate.md): Complete reference for sightmap serve-sightmap, skills install, and version — serve the compiled corpus over HTTP with hot reload, install the embedded agent skills, and check the binary version.
- [Sightmap Browser Commands: Interacting with the Live Page](https://docs.sightmap.org/cli/interaction.md): Click, fill, scroll, and screenshot a live page — targeting elements by semantic component identity instead of brittle CSS.
- [Sightmap CLI Reference: Conventions, Shared Flags, and Exit Codes](https://docs.sightmap.org/cli/overview.md): Learn the conventions every sightmap command shares — flag placement, session flags, visibility defaults, and exit codes — then jump to the right command group.
- [Sightmap CLI: Selector Tools Reference](https://docs.sightmap.org/cli/selectors.md): Complete reference for the sightmap selector tools: suggest, gap, sel-probe, and sel-check — discover selector candidates, find coverage gaps, and verify every selector before it enters your corpus.
- [Sightmap View Sets: Capture Layout, the Novelty Gate, and Pruning](https://docs.sightmap.org/cli/snapshots.md): How Sightmap organizes captures on disk — a view is a set of timestamped snapshots scored as a union — plus snapshot-novelty, snapshot-prune, and migrate-snapshots.
- [Curator vs. Consumer: The Two Roles Around a Sightmap](https://docs.sightmap.org/concepts/curator-vs-consumer.md): Understand who writes .sightmap/ and who reads it — and why consumers stay small while curation carries the judgment work.
- [Selectors and Match Strategy in Sightmap](https://docs.sightmap.org/concepts/selectors.md): Why sightmaps point at the UI with CSS selectors, how selector arrays survive refactors, and how views and requests resolve their matches.
- [Sightmap vs. README, sitemap.xml, OpenAPI, and Agent Rule Files](https://docs.sightmap.org/concepts/vs.md): See how a sightmap complements the files your project already has — and fills the gap between the URL, the DOM, the API, and the institutional knowledge.
- [Why Agents Need a Sightmap](https://docs.sightmap.org/concepts/why.md): Agents guess at your app's surface and forget what they learn — a sightmap ends the guessing and makes the learning permanent.
- [The Curation Workflow: Bootstrap and Maintain a Sightmap](https://docs.sightmap.org/concepts/workflow.md): Bootstrap .sightmap/ from the running app with the sightmap CLI, then keep it aligned as routes, components, and quirks evolve.
- [Sightmap: A Memory System for AI Agents That Use Your Web App](https://docs.sightmap.org/index.md): An open YAML format and CLI that maintain a shared memory of your web app — views, components, and API requests, curated by agents against the running app.
- [Sightmap Conformance Fixtures: The Language-Agnostic Test Suite](https://docs.sightmap.org/reference/conformance-fixtures.md): The fixture catalog, how the assertions run, and how to contribute a new fixture.
- [Contributing to Sightmap: DCO Sign-Off, SEPs, and the Monorepo](https://docs.sightmap.org/reference/contributing.md): Where to discuss changes, how the DCO sign-off works, and how spec changes flow through the SEP process.
- [Sightmap Glossary: Views, Components, Coverage Tiers, and More](https://docs.sightmap.org/reference/glossary.md): Definitions for view, component, request, memory, selector, curator, consumer, coverage tiers, novelty gate, component query, and stream version.
- [Use Sightmap as a Go Library](https://docs.sightmap.org/reference/go-library.md): Import the same corpus loading, selector matching, and CDP client that power the sightmap CLI into your own Go tools.
- [Sightmap JSON Schema: Editor Validation and CI Setup](https://docs.sightmap.org/reference/json-schema.md): Wire sightmap.schema.json into your editor and CI for validation, autocomplete, and hover docs on every .sightmap/ file.
- [Sightmap Schema Reference](https://docs.sightmap.org/reference/schema.md): Exhaustive field-level reference for the Sightmap v1 YAML format, generated from the canonical spec.
- [Sightmap Versioning Policy: Spec Stream vs Project SemVer](https://docs.sightmap.org/reference/versioning.md): How the integer spec stream and the project's SemVer releases evolve independently, and what counts as a breaking change.
- [Sightmap Components: Selectors, Children, and References](https://docs.sightmap.org/spec/components.md): Name DOM subtrees with CSS selectors — single strings or ordered alternatives, scoped children, and shared $ref definitions.
- [Sightmap Conformance: The Rules Implementations Must Follow](https://docs.sightmap.org/spec/conformance.md): What it means for an implementation to conform to the spec, and where the executable definition — the conformance fixtures — lives.
- [Sightmap Memory: Durable Notes Agents Read at Runtime](https://docs.sightmap.org/spec/memory.md): Attach short freeform notes to files, views, components, and requests so every quirk you learn once is surfaced to the next agent.
- [The Sightmap Specification: YAML Format Overview](https://docs.sightmap.org/spec/overview.md): How a sightmap describes an app — views, components, requests, and memory — in a directory of YAML files under .sightmap/.
- [Sightmap Requests: Routes, Methods, and Payload Shapes](https://docs.sightmap.org/spec/requests.md): Name API endpoints with glob routes and optional method filters — every matching request applies, so order never matters.
- [Sightmap Views: Routes, Specificity, and Scoping](https://docs.sightmap.org/spec/views.md): Name screens by URL route with glob patterns — the most specific route wins, so you never hand-order your views.
- [Choose Your Path: Sightmap for App Authors, Curators, and Tool Builders](https://docs.sightmap.org/start/choose.md): Three audiences — app authors, curator agents, consumer tool builders — and the right first page for each.
- [Install the Sightmap CLI](https://docs.sightmap.org/start/install.md): Install paths for the sightmap CLI, the agent skills, the Go library, and editor schema validation.
- [Sightmap Quickstart: Bootstrap a .sightmap/ From Your Running App](https://docs.sightmap.org/start/quickstart.md): From install to a populated .sightmap/ — agent-driven, against your running app, with the sightmap CLI.
- [What Is Sightmap? The Open Spec That Teaches Agents Your Web App](https://docs.sightmap.org/start/what-is-sightmap.md): A two-paragraph framing of the Sightmap open spec — who reads it, and what one learned artifact gives every agent that follows.