Skip to main content
Clawdi detects supported Agent software on your computer and lets you connect Claude Code, Codex, Hermes, OpenClaw, Pi, or OpenCode. Each selected installation keeps running locally and becomes a Connected Agent in Clawdi.

​
Connect from the dashboard

  1. In the Clawdi dashboard, choose New Agent, then Connect an Agent on your machine.
  2. Choose Ask your agent and copy the setup prompt into supported Agent software on that computer. Review the requested setup actions.
  3. Complete browser authorization and follow the setup prompts.
  4. Return to Clawdi and check that the connected Agent appears.
Ask your agent setup tab with a copyable prompt and waiting-for-connection state. The setup dialog waits while you complete the connection on your computer. View full-size image Prefer to run the commands yourself? Follow the Connected Agent quickstart. Your computer needs to stay available for local work and syncing.

​
Supported Agent software

Agent software is a separate choice from where the Agent runs. Pi and OpenCode connect for Session sync only. Clawdi does not install its bundled Skill or configure MCP for these integrations.

Advanced: setup commands and connection recovery

​
Detect and connect installed software

Run the interactive setup:
Clawdi checks the standard location for each supported option. Installed Agent software is selected by default; a data directory left by an older installation can appear without being selected.For the selected software, setup performs these user-visible actions:
  1. Registers an Agent and this computer with Clawdi.
  2. Adds the Clawdi MCP server where supported.
  3. Installs the bundled clawdi Skill where supported.
  4. Ensures the background sync daemon is installed and running.

​
Select one software option

Use --agent when automatic detection misses an installation or when you want to configure only one option. The flag identifies Agent software; it does not select the Agent’s run location.
Accepted values are:
For non-interactive setup, --yes registers every detected option:
--yes selects every detected option. Use --agent <software> when you want to limit setup to one.

​
Verify the connection

If an Agent’s MCP tools look stale, refresh its local wiring and restart the daemon:
Replace codex with the matching value from the list above.

​
Recover a lost connection

If this computer was previously connected, restore its existing Agent instead of registering another one:
Select the intended existing Agent when prompted. If you already know its ID:
Reconnecting can replace the Agent’s connection to another computer. Review any takeover prompt before confirming. Signing out preserves local Agent registrations for a later sign-in to the same account; another account cannot reuse those registrations.Run clawdi agent reconnect --help for non-interactive and daemon options.

​
Remove local integration

To reverse setup for one Connected Agent:
Use clawdi teardown --help to review the current options before removing more than one Agent’s local integration.
Last modified on September 10, 2026