Skip to main content
Draft: these steps await verification against the current release of AgentKit.
Outcome: an agent has a server node beside This Mac, one of its services runs on that server, and sessions can run there too. An agent stays one agent wherever it runs. A node is a place it is set up: This Mac, or a server. AgentKit creates a server node as a resource on its own Coolify and keeps it updated.

What you need

  • An agent on This Mac.
  • AgentKit’s Coolify connection in Settings > Coolify. If there is none, Add Node offers Create instance as its first step.
  • Enough free memory on one of the Coolify’s servers for the node.

Steps in the app

1

Start Add Node

Open the agent’s page and choose Options (⋯) > Add Node. For an agent that already has a Nodes section, its last tile does the same.
2

The server

Choose the server. When AgentKit has no Coolify yet, this step goes through Create instance.
3

Where it runs

Choose among the servers of AgentKit’s Coolify; each shows its free memory.
4

The node's memory

Set how much memory the node gets.
5

Sign-ins and services

Choose the node’s sign-ins, such as Claude or Codex and capability connections, and which services move to it.Steps already settled are checked and passed over, a failed step says why with Retry, and closing the sheet keeps where it stood.
6

Move a service later with Runs on

To move a service afterwards, open the capability’s tile on the agent’s page. The view of a capability whose service runs in one place has Runs on, a choice of the agent’s nodes. Choose the server; it reads Moving until the service has started there.

Steps by command line

Nodes are the capabilities manager’s: capabilities node list and capabilities node state show them, and capabilities help gives the full reference.

Check it worked

  1. The agent’s page shows a Nodes section with This Mac and the server. The server’s tile carries a green dot while one of the agent’s services runs there.
  2. The capability’s Runs on shows the server, no longer Moving.
  3. Nodes in the sidebar lists the server; its page shows the agent and its services.
  4. New’s menu on the agent’s page has a Run on section with the server. Start a session there; its row shows a server glyph after the agent’s name.

Common failures

TODO: verify whether Add Node asks to grant the agent AgentKit’s Coolify connection. The product’s settled design says a node goes through AgentKit’s own connection with no grant to the agent; an earlier release note said Create asks once and grants it.