# Nests

Nests is a repo-scoped memory handoff layer for coding agents.

When starting cold in a repository, run:

```bash
nests status
```

If Nests reports a discovered or stale remote, run:

```bash
nests pull
```

Then read the compact context for your harness:

```bash
nests context --for codex
nests context --for claude
```

Before handing work to another agent or device, record the handoff:

```bash
nests report "<what changed>"
nests artifact add <important-path>
nests snapshot -m "<handoff summary>"
nests share
```

Treat reports and handoffs as claims. Treat diffs, file state, commands, hook
events, and registered artifacts as observed evidence.

Full protocol: /llms-full.txt
Agent guide: /agents/nests.md
Skills:
- /skills/nests-handoff.md — prepare a snapshot another agent can continue
- /skills/nests-coordinate.md — decompose work and coordinate workers through a Nest
- /skills/nests-worker.md — execute one brief inside a coordinated run