Use Agent Connectors
Connect a computer and select it as the runtime device when creating an Agent.
Agent Connectors link your computer to Buda. Select that computer when creating an Agent so it can run code, shell, filesystem, and Git operations there. Browser tools are also available when Chrome, Chromium, or Microsoft Edge is installed.
Before you start
- Install Node.js 24.18 or later on the computer you want to connect.
- Make sure the computer can reach
https://buda.im. - Keep the computer and Connector process running while the Agent uses it.
Add a Connector
Open the Space that should use the Connector and go to Settings → Agent Connectors.
Click Add connector. If the page says no install command is available yet, click Generate token first.
Click Copy to copy the complete install command shown on the page.
Open a terminal on the computer you want to connect, paste the command, and run it. Do not close the terminal process running Connector.
Return to Buda and wait for the connection. The page shows Device found first, then Connector ready when setup is complete.
Click Create agent on this device. You can also close the dialog and create an Agent later: choose Local mode / remote host under Runtime, then select the connected device.
After the Agent is created, chat with it as usual. As long as Connector remains online, that Agent uses the selected computer for its work.
Reconnect an offline device
- Go to Settings → Agent Connectors.
- Click Connect device beside the offline device.
- Copy the command from the dialog and run it in a terminal on the original computer.
- Wait for Connector ready. Linked Agents can then use the computer again.
Troubleshooting
- The page keeps waiting after you copy: make sure you ran the command in the target computer's terminal, rather than only copying it.
- Device found never becomes ready: keep the terminal process running and check the computer's network connection.
- The device shows offline: the computer may be asleep, disconnected, or no longer running Connector. Wake it and run the connection command again.
- The Agent cannot use browser tools: install Chrome, Chromium, or Microsoft Edge on the target computer, then restart Connector.
Related
Slack (tools)
Give an agent Slack access so it can read channels and post updates — turning Slack into a tool the agent uses, not a tab you babysit.
MCP with Claude
Drive your Buda agents from Claude Desktop over the Model Context Protocol — authenticate with an API key and call Buda right from your chat.