DOCSOverview
Run a policy-aware agent on Mantle.
A few commands take you from install to a live chat. The chapters that follow walk the four-gate write pipeline, the CLI and config reference, and the operator console at /console.
- Architecture
A Bun monorepo. An advisory brain, a deterministic control layer, and a four-gate write pipeline on Mantle.
- Identity
The agent is a plain EOA with a local encrypted keystore. No on-chain mint required to start.
- Memory
A local, content-addressed store. Markdown notes plus an index, kept on the operator's machine.
- Brain
Any OpenAI-compatible model. Advisory only, never the safety boundary.
- Tools
The Mantle limbs plus the host harness. Reads run freely; every write crosses the gates.
- CLI
The nebula binary. Init an agent, chat, bridge Telegram, run the gateway.
- Configuration
Configure the brain and the fund-control policy entirely from the environment. No code changes.
- For Agents
How AI agents (Claude Code, Codex, Cursor) install and operate Nebula for a human. What works, what to hand back, what never to claim.