Nucleus
Nucleus is ClusterCode’s built-in AI assistant. It lives in the orchestrator dashboard and helps you manage workers, launch DevBoxes, execute commands, and monitor your cluster — all through natural conversation.
What Nucleus Can Do
Section titled “What Nucleus Can Do”- Launch DevBoxes from tickets — “Launch a DevBox for github.com/org/repo/issues/42”
- Execute commands — “Run npm start in DevBox X” or start long-running processes in the background
- Open terminals and displays — “Open a terminal on DevBox X” or open a VNC display for GUI interaction
- Build images — “Build the claude-code-terminal image” with composable capabilities
- Monitor status — “What’s running on worker-1?” or get details on a specific DevBox
- Fetch tickets — Pull details from GitHub Issues or Azure DevOps work items
- Navigate the UI — Nucleus can direct you to any page in the dashboard
- Read docs — Nucleus can look up ClusterCode documentation to answer your questions
How It Works
Section titled “How It Works”When you ask Nucleus to do something, it:
- Interprets your request
- Takes the action on your cluster
- Confirms with you before executing destructive operations
- Reports the result
Budget
Section titled “Budget”Nucleus sessions use AI credits from your plan allowance:
| Resource | Free | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Platform AI allowance | None | $2/mo | $6/mo | $10/mo |
5× / 20× mark limits where Pro is exactly 5× Starter and Enterprise 20×.
On Enterprise the allowance is per user.
You can also bring your own key in Settings → Environment Variables — an Anthropic API key or a Claude OAuth token — for usage beyond your plan. See AI Credits for how the allowance works.
- Ask Nucleus to launch a DevBox from a GitHub issue or Azure DevOps ticket
- Enable host networking when launching to test from your phone at host-ip:port
- Try: “Open a terminal on DevBox X” to get a live shell
- Nucleus will confirm launch details with you before creating a DevBox