Draft: these steps await verification against the current release of AgentKit.
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
- 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.
- The capability’s Runs on shows the server, no longer Moving.
- Nodes in the sidebar lists the server; its page shows the agent and its services.
- 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.