Operator guide
Get Nexus running and drive your first goal end-to-end.
1. Stand up the platform
Follow Operations to run MongoDB, NATS, Nexus Core, the worker, and the UI — locally or on Kubernetes via nexus-gitops.
2. Create an agent
In the UI → Agents → Create agent. Fill in name, model, runtime image and resources, attach a skill or two, choose memory scopes, set permissions. No deploy needed — it's a document. See Concepts: Agents.
3. Create a goal
From the UI or Telegram:
/nexus create goal "Build authentication system for my app"
Nexus drafts tasks and waits for your approval.
4. Approve the plan
In the UI → Board, review the drafted tasks, adjust, and approve. Approved
tasks become ready_for_agent and (if Plane is wired) appear as Plane work
items.
5. Watch a run
The scheduler leases a ready task and launches a Kubernetes Job. In the UI →
Runs, follow live logs, files changed, and commands run. Approve any gated
action (e.g. database_migration) in Approvals.
6. Tune
If an agent underperforms, adjust its skills/permissions or clone it. Repeated failures trigger quarantine.