How to Uninstall Agent Reach: Complete Removal of Configurations and Skill Files

Run agent-reach uninstall to remove all configuration files, skill registrations, and MCP entries, then run pip uninstall agent-reach to delete the Python package.

Agent Reach is an open-source automation tool hosted at Panniantong/Agent-Reach. The tool includes a built-in uninstaller implemented in agent_reach/cli.py that cleanly removes all user data, configuration files, and platform-specific integrations. This guide explains how to uninstall Agent Reach completely, what gets removed from your system, and how to use the available flags to customize the cleanup process.

What Gets Removed During Uninstallation

The uninstallation process targets three specific areas of your file system. According to the _cmd_uninstall function in agent_reach/cli.py (lines 59-101), the tool removes the following components:

Configuration Directory

The uninstaller deletes the ~/.agent-reach directory, which contains your config.yaml file. This configuration file stores all saved tokens, cookies, and API keys used by Agent Reach. If you use the --keep-config flag, the tool preserves this directory while still removing other components.

Agent Skill Files

Agent Reach registers skill files with multiple agent platforms. The uninstaller removes the agent-reach skill directories from the following locations:

• ~/.openclaw/skills/agent-reach
• ~/.claude/skills/agent-reach
• ~/.agents/skills/agent-reach

The script recursively deletes these directories after verifying their existence, reporting the status of each removal operation.

MCP Integrations

If you have mcporter installed, the uninstaller cleans up MCP (Model Context Protocol) entries specific to Agent Reach. It identifies and removes entries such as exa and xiaohongshu by running mcporter list and deleting the relevant configurations.

How to Use the Built-in Uninstaller

The primary command to remove Agent Reach is:

agent-reach uninstall

This command executes the _cmd_uninstall function and performs a complete cleanup of all configuration files, skill registrations, and MCP entries. The uninstaller is idempotent: running it multiple times safely reports that nothing remains after the initial successful execution.

Uninstaller Flags

You can customize the uninstallation behavior using two optional flags:

Flag	Purpose
--dry-run	Previews all paths that would be removed without deleting any files. Use this to verify what data will be deleted before committing to removal.
--keep-config	Preserves the ~/.agent-reach directory containing your config.yaml file while removing skill files and MCP entries. Useful if you plan to reinstall Agent Reach later.

To preview the uninstallation:

agent-reach uninstall --dry-run

To remove everything except your configuration:

agent-reach uninstall --keep-config

Manual Uninstallation Steps

If you prefer manual cleanup or if the CLI tool is unavailable, you can replicate the uninstallation process using standard shell commands. Note that this requires the mcporter CLI if you need to remove MCP entries.

Remove the configuration directory and skill files:

# Remove configuration files (contains credentials)

rm -rf "$HOME/.agent-reach"

# Remove skill registrations for all supported agent platforms

rm -rf "$HOME/.openclaw/skills/agent-reach"
rm -rf "$HOME/.claude/skills/agent-reach"
rm -rf "$HOME/.agents/skills/agent-reach"

Clean up MCP entries manually:

# Remove specific MCP configurations

mcporter config remove exa
mcporter config remove xiaohongshu

Finally, remove the Python package itself:

pip uninstall agent-reach

Summary

Agent Reach provides a comprehensive uninstallation mechanism that ensures no residual data remains on your system:

• Run agent-reach uninstall to execute the built-in cleanup routine defined in agent_reach/cli.py
• The command removes the ~/.agent-reach config directory, platform-specific skill files, and MCP entries
• Use --dry-run to preview changes without making filesystem modifications
• Use --keep-config to preserve your credentials while removing integrations
• Always run pip uninstall agent-reach afterward to remove the Python package itself
• The uninstaller only touches files in your home directory and never modifies system-wide locations

Frequently Asked Questions

Does the uninstaller remove the Python package automatically?

No. The agent-reach uninstall command only removes user data, configuration files, and skill registrations. You must run pip uninstall agent-reach separately to remove the Python package and the agent-reach CLI command from your system.

Can I recover my configuration after uninstalling?

No, unless you use the --keep-config flag. When you run the standard uninstall command without flags, the ~/.agent-reach directory is permanently deleted, including your config.yaml file containing all tokens and API keys. Always back up this directory before uninstalling if you need to preserve these credentials.

What happens if I run the uninstall command multiple times?

The uninstaller is idempotent. According to the implementation in agent_reach/cli.py, running the command again after a successful cleanup simply reports that the target paths do not exist, making it safe to run repeatedly without errors.

Does Agent Reach modify system directories during installation or uninstallation?

No. Agent Reach only creates and removes files within your user home directory. The uninstaller never touches system-wide locations such as /usr/local, /opt, or Windows system directories, ensuring the process is safe and does not require administrative privileges.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}