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.

​
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.

​
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 8, 2026