Agents

An agent in NEXUS is a persistent identity — a name, a persona, and its own on-disk memory — independent of any terminal. Creating or editing an agent never starts a process; Start Shell is the only action that spawns a terminal for it.

This guide is split across six pages:

Page	Covers
Creating Agents	The three creation paths — New Agent, Create with AI, Import Agent — and managing the roster.
Persona & Identity	Avatar, name, accent color, and the five persona fields.
Autonomy Modes	Auto, Approval, Plan, and Plan (collect) — and the destructive-action boundary that holds regardless of mode.
Providers & Working Directory	Which command-line AI runs when you start a shell, and where.
Capabilities & Skills	Mesh capabilities, discovered and attached skills, and attached files.
Running & Monitoring	Start Shell, pausing and killing a session, and the live status vocabulary.

Where to go next

• Settings reference — the same persona and autonomy fields, from the contextual settings panel.
• Settings guide — the staged Save/Cancel behavior that panel shares with Workspace, Session, Bit Page, and File.
• Neural Map — an agent's session as a node, and what drilling into it does.
• Window & Panes — flipping a running agent's pane between Terminal and Agent & Skills.