Nucarium documentation

You leave coding agents running on a small machine. One stops to ask a question and waits all night. These pages are how you build that machine, keep its work tidy, and hear the moment an agent needs you.

What Nucarium is #

A small Linux machine at home or in a closet, a box, runs coding agents around the clock. You start sessions on it from your phone or laptop and walk away. Nucarium gives that machine a well-shaped workspace, keeps it healthy, and tells you when an agent is waiting, stuck, finished, or gone.

It has two halves. The tools on the box are open source and work with no account:

  • nucleate gives every agent session its own folder with only the repos it needs, and removes that folder only when nothing in it is unsaved.
  • nucleated is a small daemon. It sends a heartbeat, reports what each session is doing, and runs the housekeeping: fetching, cleaning up, and saving work in progress.
  • The box recipe is an Ansible playbook and these pages. It takes bare hardware to an encrypted, firewalled box that restarts by itself after a power cut.

The other half is hosted. Nucarium Watch is one list of every session on every box you run, with whatever is waiting on you at the top. It tells you once when an agent needs you or a box goes dark, and once more when that is sorted. Your first environment is free.

What it never does #

Watch observes. It never starts, approves, stops or messages a session, and it has no way to send a command to a box. When something needs you, you answer it in your agent vendor's own app.

It also never sees your work. nucleated sends what happened, never what was said:

Nucarium Watch sees which agent is doing what, where and since when — never what it was told or what it wrote.

What leaves the box lists every field, and how that is enforced.

Where to start #

The three routes at the top of this page are the usual ways in. If you are not sure which you are:

You have Start with
A box already running agent sessions Connect a box to Watch. It installs nucleated on the way.
Hardware on the desk, or on order Build a box. The last pages connect it to Watch.
Agents on your own laptop or a server, and repos that collide nucleate by itself.
A rule that no metadata may leave your network nucleate, and nucleated with no target at all.

If the words machine, environment, session and nucleus are new, How the pieces fit takes two minutes and makes every other page easier.