# How to Uninstall Agent Reach: Complete Removal of Configurations and Skill Files > Completely uninstall Agent Reach by running agent-reach uninstall to remove configurations and skill files, then uninstall the Python package with pip. - Repository: [Pnant/Agent-Reach](https://github.com/Panniantong/Agent-Reach) - Tags: how-to-guide - Published: 2026-07-05 --- **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`](https://github.com/Panniantong/Agent-Reach/blob/main/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`](https://github.com/Panniantong/Agent-Reach/blob/main/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`](https://github.com/Panniantong/Agent-Reach/blob/main/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: ```bash 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`](https://github.com/Panniantong/Agent-Reach/blob/main/config.yaml) file while removing skill files and MCP entries. Useful if you plan to reinstall Agent Reach later. | To preview the uninstallation: ```bash agent-reach uninstall --dry-run ``` To remove everything except your configuration: ```bash 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: ```bash # 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: ```bash # Remove specific MCP configurations mcporter config remove exa mcporter config remove xiaohongshu ``` Finally, remove the Python package itself: ```bash 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`](https://github.com/Panniantong/Agent-Reach/blob/main/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`](https://github.com/Panniantong/Agent-Reach/blob/main/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`](https://github.com/Panniantong/Agent-Reach/blob/main/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.