---
slug: "nervous-system"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/10ego/NERVous-system@main/README.md"
repo: "https://github.com/10ego/NERVous-system"
source_file: "README.md"
branch: "main"
---
# NERVous System

A durable multi-agent orchestration and coding-agent coordination framework for [pi](https://pi.dev). NERVous System helps coding agents **plan, delegate, coordinate, execute, recover from interruptions, and review** work continuously.

**Invoke `/nervous`, give it a task description, and walk away.**

Find it in the [pi package directory](https://pi.dev/packages) by searching for **multi-agent orchestration**, **coding-agent coordination**, **subagent delegation**, **durable task planning**, **workflow recovery**, or **risk triage**.

## Quick start

```bash
pi install npm:nervous-system
```

Then start a durable workflow:

```text
/nervous implement this feature with durable planning and worker delegation
```

NERVous installs the complete suite: CORTEX, MAGI, AXON, SYNAPSE, LION, CEREBEL, GANGLION, AMYGDALA, and the dashboard. Its model tools are inactive in a fresh session chain. An exact `/nervous [task]` command activates the operator-permitted component set after any current run becomes idle, then keeps the coordinated workflow available for later turns on that branch. Keep the package installed but turn its runtime resources off or back on with `/nervous:config enabled=false` or `/nervous:config enabled=true`. Use `/nervous:state` to see exactly what the current work context retains and `/nervous:reset` to archive that whole context before unrelated work.

## Highlights

- One-time task framing turns abstract requests into concrete goals before deliberation
- Durable goals and task state that survive compaction, restarts, and interruptions
- Pi-native transport retries with an explicit settled-interruption resume valve
- Deliberation, risk triage, and explicit verification for difficult work
- Parallel coding subagents with orchestration, capacity allocation, and live progress
- Project- and context-isolated state with explicit retention diagnostics, safe reset archives, and a fault-isolated dashboard

## Documentation

| Guide | Contents |
|-------|----------|
| [Documentation index](https://github.com/10ego/NERVous-system/blob/HEAD/docs/README.md) | Suggested reading paths and all guides |
| [Getting started](https://github.com/10ego/NERVous-system/blob/HEAD/docs/getting-started.md) | Installation, first use, updates, removal, and local development |
| [Architecture](https://github.com/10ego/NERVous-system/blob/HEAD/docs/architecture.md) | Components, execution flow, repository layout, and package design |
| [Operations](https://github.com/10ego/NERVous-system/blob/HEAD/docs/operations.md) | Worker controls, dashboard, state isolation, and configuration |
| [Benchmark](https://github.com/10ego/NERVous-system/blob/HEAD/docs/benchmark.md) | NERVous prompts compared with a raw LLM baseline |
| [Release policy](https://github.com/10ego/NERVous-system/blob/HEAD/RELEASES.md) | Version compatibility, state policy, and known limitations |

> **Status:** The complete core component set and deterministic end-to-end demo are implemented and tested.