---
title: For AI agents
description: How AI coding agents work with Nori — skills, the CLI's MCP client, and machine-readable reference.
---

Nori is built agent-first, and these docs are meant to be legible to AI coding
agents as well as people.

## Public skills

Two general-purpose skills are maintained alongside these docs (in the site
repo's `skills/` directory) and distributed through [Skillsets](/skillsets/):
**`nori-info`** (what Nori is, with canonical pointers) and **`nori-docs`**
(how to fetch this site as raw markdown). They are pointers, not copies — the
pages here stay canonical.

## MCP with the CLI

The [Nori CLI](/cli/) is an **MCP client**: you connect [Model Context
Protocol](/cli/guides/mcp-and-hooks/) servers and it forwards their tools to
whatever agent you're running. It is not itself a general-purpose MCP server you
point other tools at — see [MCP and hooks](/cli/guides/mcp-and-hooks/).

## Fetching these docs as markdown

Every page has a raw-markdown twin: append `.md` to its path, dropping any
trailing slash (`/cli/start/install/` → `/cli/start/install.md`). Two index
files cover the whole site: [/llms.txt](/llms.txt) (curated map with one-line
descriptions) and [/llms-full.txt](/llms-full.txt) (the entire corpus in one
file).

## Machine-readable reference

Where a page documents CLI help, keybindings, or supported agents, it is
**generated** from the source repo and stamped with provenance
(`source: <repo>@<commit>`); the reference groups carry a **Generated** badge in
the sidebar. Never edit those pages by hand — regeneration overwrites them, and
a drift gate diffs them in CI.