Skip to main content
Most users should install the sightmap CLI from npm, then add the bundled agent skills. This is a one-time setup — afterward your agent drives the browser session and runs the CLI through those skills.

​
The CLI

The npm package installs the native binary for your platform and does not require a Go toolchain. Most commands accept --sightmap-dir <dir> to point at a corpus outside the current directory. See the CLI reference for the full command surface.

​
The agent skills

This installs two skills in ~/.agents/skills. Pass --target <dir> to use another directory.
  • sightmap-authoring builds and maintains a corpus.
  • sightmap-browser drives a live session using a finished corpus.

​
The browser

sightmap browser start needs a Chrome it can launch. If you don’t have one available, install a managed Chrome for Testing:

​
The Go library

Tools that consume sightmaps can import the Go module for corpus loading, selector matching, and the component model:
See the package map and Curator vs consumer.

​
Editor schema validation

Add this schema directive to your .sightmap/ YAML files for in-editor validation:
See JSON Schema for editor-specific setup.

​
Requirements

  • CLI from npm: Node 18+.
  • CLI from source: Go 1.25.2+.
  • Skills: A skills-aware agent harness.
  • A Chrome the CLI can launch (see The browser above).

​
Next steps