# Nori Docs

> Documentation for the Nori product suite: Sessions (with handroll), the CLI, and Skillsets.

Every page is available as raw markdown: append `.md` to its path (dropping the
trailing slash). Fetch those URLs to get clean markdown instead of rendered HTML.
The full corpus in one file: https://docs.noriagentic.com/llms-full.txt

## overview

- [Nori CLI](https://docs.noriagentic.com/cli.md): The open-source agentic coding terminal — one harness for any ACP agent.
- [Nori](https://docs.noriagentic.com/index.md): Take any team of AI coding agents cloud-native — any harness, any token provider, any integrations, any compute. Fully-managed agents in Slack, or bring your own multi-agent cloud.
- [Nori Sessions](https://docs.noriagentic.com/sessions.md): Managed cloud sessions for AI coding agents — a warm fleet of VMs, reachable from Slack, Discord, the web, or your terminal.
- [Nori Skillsets](https://docs.noriagentic.com/skillsets.md): The open-source skill manager — one skillset, installed into any coding agent.

## cli

- [The Agent Client Protocol](https://docs.noriagentic.com/cli/concepts/acp.md): ACP is the host-agent contract that lets Nori run any compatible coding agent.
- [Agents & harnesses](https://docs.noriagentic.com/cli/concepts/agents-and-harnesses.md): Nori is the harness — an ACP host that runs your coding agent as a separate process.
- [Sessions, history & transcripts](https://docs.noriagentic.com/cli/concepts/sessions-and-transcripts.md): Where Nori keeps session state on disk, and the documented JSONL transcript format.
- [Develop](https://docs.noriagentic.com/cli/develop.md): How the CLI is built, and how to contribute.
- [Architecture](https://docs.noriagentic.com/cli/develop/architecture.md): A harness, not an agent — three layers, strict downward dependencies.
- [Guides](https://docs.noriagentic.com/cli/guides.md): Agents, sessions, approvals, MCP, hooks, and cloud.
- [Agents](https://docs.noriagentic.com/cli/guides/agents.md): Run the built-in agents or register any ACP agent of your own.
- [Approvals & sandboxing](https://docs.noriagentic.com/cli/guides/approvals.md): Three presets from read-only to full access, enforced by OS-level sandboxes.
- [Cloud](https://docs.noriagentic.com/cli/guides/cloud.md): Run the same TUI against a cloud session in your org's fleet.
- [MCP & hooks](https://docs.noriagentic.com/cli/guides/mcp-and-hooks.md): Connect MCP servers and run your own scripts at session lifecycle boundaries.
- [Sessions](https://docs.noriagentic.com/cli/guides/sessions.md): Resume, fork, compact, and undo — sessions are durable and rewindable.
- [Reference](https://docs.noriagentic.com/cli/reference.md): Commands, config, slash commands, keybindings.
- [Commands](https://docs.noriagentic.com/cli/reference/commands.md): The nori binary's subcommands and flags.
- [config.toml](https://docs.noriagentic.com/cli/reference/config.md): Every configuration section of ~/.nori/cli/config.toml.
- [Keybindings](https://docs.noriagentic.com/cli/reference/keybindings.md): Default hotkeys and the config keys that rebind them.
- [Slash commands](https://docs.noriagentic.com/cli/reference/slash-commands.md): Every in-TUI command, in the order the popup shows them.
- [Start](https://docs.noriagentic.com/cli/start.md): Install the CLI and run your first agent.
- [Install](https://docs.noriagentic.com/cli/start/install.md): Install the Nori CLI and run your first agent session.

## resources

- [FAQ](https://docs.noriagentic.com/resources/faq.md): Common questions about Nori — the products, the open-source core, providers, and compute.
- [For AI agents](https://docs.noriagentic.com/resources/for-agents.md): How AI coding agents work with Nori — skills, the CLI's MCP client, and machine-readable reference.

## sessions

- [Checkpoints & resume](https://docs.noriagentic.com/sessions/concepts/checkpoints-and-resume.md): How session state is captured so work can be resumed after the machine is gone.
- [Fleets, brokers & compute](https://docs.noriagentic.com/sessions/concepts/fleets-and-providers.md): How the broker schedules sessions onto a pool of cloud machines across pluggable compute backends — and why provider is not the same as harness.
- [Harnesses & personalities](https://docs.noriagentic.com/sessions/concepts/harnesses-and-personalities.md): A harness is the coding agent that runs inside a session; a personality is the skillset applied to it at provision time.
- [What is a session](https://docs.noriagentic.com/sessions/concepts/what-is-a-session.md): A session is one agent run bound to a cloud VM, tracked by the broker through a lifecycle from warm pool to release.
- [Guides](https://docs.noriagentic.com/sessions/guides.md): Task-shaped feature docs for Sessions.
- [Integrations & credentials](https://docs.noriagentic.com/sessions/guides/integrations.md): Connect agent providers, GitHub, Slack, Google Workspace, MCP servers, and custom secrets — the platform handles rotation and distribution.
- [Slack](https://docs.noriagentic.com/sessions/guides/slack.md): Drive cloud agent sessions from Slack threads — mentions, commands, and access control.
- [Triggers](https://docs.noriagentic.com/sessions/guides/triggers.md): Start sessions on a schedule, a reminder, or an inbound webhook.
- [Web dashboard](https://docs.noriagentic.com/sessions/guides/web-dashboard.md): Chat, session history, fleet health, and org configuration at <org>.norisessions.com.
- [Handroll](https://docs.noriagentic.com/sessions/handroll.md): The terminal client for Sessions.
- [Handroll configuration](https://docs.noriagentic.com/sessions/handroll/configuration.md): The on-disk config files, the environment variables, and the fixed prefix key.
- [Hand-off & resume](https://docs.noriagentic.com/sessions/handroll/handoff-and-resume.md): Moving a session between your terminal and the cloud — and what's supported today.
- [Usage](https://docs.noriagentic.com/sessions/handroll/usage.md): Wrap your local agent, work through the overlay, and bridge cloud sessions into local tools.
- [Reference](https://docs.noriagentic.com/sessions/reference.md): Lifecycle states, configuration, and limits.
- [Configuration](https://docs.noriagentic.com/sessions/reference/config.md): Every org-level knob — fleet, defaults, Slack policy, workspace — with types and defaults.
- [Session lifecycle](https://docs.noriagentic.com/sessions/reference/lifecycle.md): The states a session machine moves through, the timeouts that drive them, and the resume contract.
- [Limits](https://docs.noriagentic.com/sessions/reference/limits.md): The numeric edges of the platform, and why each one is where it is.
- [Start](https://docs.noriagentic.com/sessions/start.md): Sign up and run a first cloud session.
- [Quickstart](https://docs.noriagentic.com/sessions/start/quickstart.md): From signup to a working cloud agent session in one sitting.

## skillsets

- [Skills & skillsets](https://docs.noriagentic.com/skillsets/concepts/skills-and-skillsets.md): A skill is one focused ability; a skillset is a complete, installable agent configuration built from skills and more.
- [The registry](https://docs.noriagentic.com/skillsets/concepts/the-registry.md): noriskillsets.dev is the registry the client installs from — public and per-org private, versioned, searchable.
- [Translation & agents](https://docs.noriagentic.com/skillsets/concepts/translation-and-agents.md): How one skillset becomes each agent's native on-disk configuration, and which agents are supported.
- [Develop](https://docs.noriagentic.com/skillsets/develop.md): Architecture and contributing.
- [Architecture](https://docs.noriagentic.com/skillsets/develop/architecture.md): One declarative agent table, layered modules, and a registry client — how sks is built.
- [Guides](https://docs.noriagentic.com/skillsets/guides.md): Authoring, managing, publishing, and MCP.
- [Authoring skills](https://docs.noriagentic.com/skillsets/guides/authoring.md): Write a SKILL.md that passes lint, package it in a skillset, and keep it honest.
- [MCP servers](https://docs.noriagentic.com/skillsets/guides/mcp.md): Author MCP config once; sks translates it for every agent's format.
- [Managing skillsets](https://docs.noriagentic.com/skillsets/guides/profiles.md): Switch safely, know what's active where, and reset when needed.
- [Publishing](https://docs.noriagentic.com/skillsets/guides/publishing.md): Share skillsets and skills on the public registry or your org's private one.
- [Reference](https://docs.noriagentic.com/skillsets/reference.md): Commands, configuration, and the agent matrix.
- [Supported agents](https://docs.noriagentic.com/skillsets/reference/agents.md): Every agent sks can install into, by support tier.
- [Commands](https://docs.noriagentic.com/skillsets/reference/commands.md): The sks command surface at a glance.
- [Configuration](https://docs.noriagentic.com/skillsets/reference/config.md): The ~/.nori-config.json keys and the env vars that override them.
- [Start](https://docs.noriagentic.com/skillsets/start.md): Install sks and activate a first skillset.
- [Install](https://docs.noriagentic.com/skillsets/start/install.md): Install sks and activate your first skillset.

## start

- [Core concepts](https://docs.noriagentic.com/start/concepts.md): The five words that describe every Nori setup — agent, harness, provider, integrations, compute — plus the managed/composable split.
- [Quickstart](https://docs.noriagentic.com/start/quickstart.md): The fastest path to a running agent — pick the entry point that matches how you want to work.
- [What is Nori](https://docs.noriagentic.com/start/what-is-nori.md): Nori takes any team of AI coding agents cloud-native — any harness, any token provider, any integrations, any compute.