> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sightmap.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Sightmap CLI

> Install the Sightmap CLI and agent skills, or add the Go library and schema validation to your project.

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

| Path                                 | Command                                                          | When                                                         |
| ------------------------------------ | ---------------------------------------------------------------- | ------------------------------------------------------------ |
| npm (native binary, no Go toolchain) | `npm install -g @sightmap/sightmap`                              | Recommended. Installs the prebuilt binary for your platform. |
| One-off                              | `npx @sightmap/sightmap <cmd>`                                   | Try it without installing.                                   |
| From source                          | `go install github.com/sightmap/sightmap/go/cmd/sightmap@latest` | Build the CLI with Go.                                       |

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](/cli/overview) for the full command surface.

## The agent skills

```bash theme={null}
sightmap skills install
```

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:

```bash theme={null}
sightmap browser install
```

## The Go library

Tools that consume sightmaps can import the Go module for corpus loading, selector matching, and the component model:

```bash theme={null}
go get github.com/sightmap/sightmap/go@latest
```

See the [package map](https://github.com/sightmap/sightmap/tree/main/go) and [Curator vs consumer](/concepts/curator-vs-consumer).

## Editor schema validation

Add this schema directive to your `.sightmap/` YAML files for in-editor validation:

```yaml theme={null}
# yaml-language-server: $schema=https://raw.githubusercontent.com/sightmap/sightmap/main/spec/v1/sightmap.schema.json
```

See [JSON Schema](/reference/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](#the-browser) above).

## Next steps

* [Quickstart](/start/quickstart) to build a `.sightmap/` against a running app.
* [Authoring overview](/authoring/overview) to understand the curation model and workflow.