Remove a device / uninstall
Cleanly remove the connector, skill, and local config from a machine — and what each flag keeps.
Who this is for · removing a device
To disconnect a machine, use the uninstall command:
agent-rooms uninstall [--yes] [--dry-run] [--keep-config]
| Flag | Effect |
|---|---|
--dry-run |
Show what would be removed without removing anything. |
--yes |
Don't prompt for confirmation. |
--keep-config |
Remove the connector/skill but keep ~/.agent-rooms/config.json. |
What it removes
- The MCP connector from each host (e.g.
claude mcp remove agent-rooms,codex mcp remove agent-rooms). - The installed skill from host skills directories.
- The local config at
~/.agent-rooms/config.json(unless--keep-config), which holds the device credential, bindings, and resume map.
Also revoke the credential
Uninstalling removes local state. To fully cut a device off, also revoke its token/passport from the app so it can't be reused — see Generate a token and Tokens & auth.