# Sightmap

- [Sightmap: Runtime Context for Agents Using Your Web App](https://docs.sightmap.org/index.md): An open YAML format and CLI for sharing runtime context about your app with Sightmap-enabled agents.
- [What Is Sightmap? Runtime Context for Agents Using Your Web App](https://docs.sightmap.org/start/what-is-sightmap.md): Give Sightmap-enabled agents and tools shared context about your app's runtime structure and behavior.
- [Install the Sightmap CLI](https://docs.sightmap.org/start/install.md): Install the Sightmap CLI and agent skills, or add the Go library and schema validation to your project.
- [Sightmap Quickstart: Build a .sightmap/ From a Running App](https://docs.sightmap.org/start/quickstart.md): Install the CLI, start a browser session, and build a checked-in .sightmap/ against your running app.
- [Sightmap vs. README Files, sitemap.xml, OpenAPI, and Agent Instructions](https://docs.sightmap.org/concepts/vs.md): Compare the runtime context in .sightmap/ with project docs, crawl maps, API contracts, and agent instructions.
- [Curator vs. Consumer: Who Writes a Sightmap and Who Reads It](https://docs.sightmap.org/concepts/curator-vs-consumer.md): Separate the tools that author and maintain .sightmap/ from the tools that load and apply it.
- [Selectors and Match Strategy in Sightmap](https://docs.sightmap.org/concepts/selectors.md): Choose stable component selectors, use ordered fallbacks, and understand how Sightmap resolves component, view, and request matches.
- [Author a Sightmap Against the Running App](https://docs.sightmap.org/authoring/overview.md): Build and maintain a .sightmap/ corpus against the running app by iterating, probing, naming, and validating each view.
- [Sightmap CLI Reference: Conventions, Shared Flags, and Exit Codes](https://docs.sightmap.org/cli/overview.md): Learn the flag placement, session flags, visibility defaults, and exit codes shared by Sightmap CLI commands.
- [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 Browser Commands: Interacting with the Live Page](https://docs.sightmap.org/cli/interaction.md): Click, fill, scroll, and screenshot a live page by probe ID, component query, or coordinates.
- [Sightmap Devtools Commands: Console and Network](https://docs.sightmap.org/cli/devtools.md): Read captured browser console messages and network requests from a running Sightmap session.
- [Sightmap CLI: Snapshot, Capture, and Inspect](https://docs.sightmap.org/cli/capture.md): Observe a live page as an annotated component tree, persist captures into a view's set, and inspect the raw DOM for selector authoring.
- [Sightmap CLI Coverage Commands: Coverage, Multi-Coverage, and Report](https://docs.sightmap.org/cli/coverage.md): Score saved captures, compare component matches across views, and report coverage for the corpus.
- [Sightmap View Sets: Capture Layout, the Novelty Gate, and Pruning](https://docs.sightmap.org/cli/snapshots.md): Understand how Sightmap stores, compares, and prunes captures for each view.
- [Sightmap CLI: Selector Tools Reference](https://docs.sightmap.org/cli/selectors.md): Use suggest, gap, sel-probe, and sel-check to find selector candidates, locate coverage gaps, and verify selectors.
- [Sightmap CLI: Corpus Health Tools Reference](https://docs.sightmap.org/cli/corpus.md): Use validate, lint, stats, search, and discover to check corpus structure, review selector quality, count what the corpus holds, find definitions, and classify linked routes.
- [Sightmap CLI: Integration Tools Reference](https://docs.sightmap.org/cli/integrate.md): Find and install corpora from the community atlas, serve or export the compiled corpus as JSON, install the bundled agent skills, and print the CLI version.
- [Sightkick: Compile WebMCP Tools From Your Sightmap](https://docs.sightmap.org/sightkick.md): Sightkick is the companion CLI that turns a .sightmap/ corpus and a YAML tool layer into WebMCP tools an agent can call by name.
- [Authoring a Sightkick Tool Layer: Tools, Steps, Returns, and Journeys](https://docs.sightmap.org/sightkick/tool-layer.md): Write the .sightkick/ YAML that turns corpus components into named WebMCP tools, and understand what the compiler checks.
- [Sightkick CLI Reference: build, browser, call, runtime, and skills](https://docs.sightmap.org/sightkick/cli.md): Every sightkick command, its flags, and what it writes, for compiling and running a WebMCP tool layer.
- [Running Sightkick Tools on a Live Page](https://docs.sightmap.org/sightkick/running.md): Inject the runtime, confirm what registered, and choose between the CLI and WebMCP execution paths.
- [The Sightmap Specification: YAML Format Overview](https://docs.sightmap.org/spec/overview.md): Learn how YAML files under .sightmap/ define views, components, requests, messages, environments, and memory.
- [Sightmap Views: Routes, Specificity, and Scoping](https://docs.sightmap.org/spec/views.md): Define named screens with URL route patterns and deterministic specificity rules.
- [Sightmap Components: Selectors, Children, and References](https://docs.sightmap.org/spec/components.md): Define named DOM subtrees with CSS selectors, scoped children, and shared $ref definitions.
- [Sightmap Requests: Routes, Methods, and Payload Shapes](https://docs.sightmap.org/spec/requests.md): Name API endpoints with glob routes, optional method filters, and documentary payload fields.
- [Sightmap Messages and Signals: Console Patterns and Named Predicates](https://docs.sightmap.org/spec/messages.md): Name console output and exceptions, extract values from a stack, and define named boolean predicates over components and views.
- [Sightmap Environments and Origins: Deploy Targets and Hosts](https://docs.sightmap.org/spec/environments.md): Name your deploy targets and the hosts each one serves, then say which views and requests run where.
- [Sightmap Memory: Durable Notes Agents Read at Runtime](https://docs.sightmap.org/spec/memory.md): Attach runtime notes to files, views, components, and requests.
- [Sightmap Conformance: The Rules Implementations Must Follow](https://docs.sightmap.org/spec/conformance.md): Understand the requirements and fixtures used to test a Sightmap implementation.
- [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 JSON Schema: Editor Validation and CI Setup](https://docs.sightmap.org/reference/json-schema.md): Configure editor feedback and CI validation for .sightmap/ files with the Sightmap v1 JSON Schema.
- [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.
- [Sightmap Versioning Policy: Spec Stream vs Project SemVer](https://docs.sightmap.org/reference/versioning.md): Distinguish the integer spec stream from project SemVer and determine which changes require a new stream.
- [Use Sightmap as a Go Library](https://docs.sightmap.org/reference/go-library.md): Use the CLI's corpus loader, selector matcher, component model, and CDP client in your Go tools.
- [Sightmap Glossary: Views, Components, Coverage Tiers, and More](https://docs.sightmap.org/reference/glossary.md): Look up the terms used throughout the Sightmap specification, CLI, and documentation.
- [Contributing to Sightmap: DCO Sign-Off, SEPs, and the Monorepo](https://docs.sightmap.org/reference/contributing.md): Choose the right contribution path, follow the SEP process for spec changes, and sign off every commit.
- [Changelog](https://docs.sightmap.org/changelog.md): New features, improvements, and fixes in the sightmap CLI, library, and spec.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.