How to Uninstall the Omarchy CLI: Complete Removal Guide

To completely uninstall the Omarchy CLI, delete the $OMARCHY_PATH/bin directory containing all omarchy-* scripts, remove the $OMARCHY_PATH root folder, clear the user configuration at ~/.config/omarchy, and clean up your shell's PATH variable.

The Omarchy CLI is distributed as a collection of standalone shell scripts rather than a system-managed package, which means no standard package manager handles its removal. Because the installation simply places executable files under $OMARCHY_PATH/bin and configuration in ~/.config/omarchy, uninstalling requires manual deletion of these directories. Follow the steps below to ensure complete removal without leaving residual binaries or environment variables.

Locate Your Omarchy Installation Root

Before removing files, identify where Omarchy resides on your filesystem. The CLI sets the environment variable OMARCHY_PATH at runtime to indicate its installation root.

Run this command to display the current value:

echo "$OMARCHY_PATH"

Common values include /usr/local/omarchy for system-wide installations or $HOME/.local/omarchy for per-user setups. Note this path for the subsequent deletion steps.

Remove Omarchy Binaries and Core Files

All Omarchy CLI commands are shell scripts prefixed with omarchy- and stored in the bin subdirectory. Deleting this directory removes every executable command.

Execute the following to remove all binaries:

rm -rf "$OMARCHY_PATH/bin"

Next, delete the entire Omarchy tree to remove shared resources such as icons, desktop files, and auxiliary helper scripts:

rm -rf "$OMARCHY_PATH"

Clean Up User Configuration

Personal settings and custom themes reside in the standard XDG configuration directory. If you want to erase all Omarchy customizations, delete the configuration folder:

rm -rf "$HOME/.config/omarchy"

This directory contains theme definitions, menu configurations, and user-specific tweaks that persist independently of the core installation.

Handle Third-Party Dependencies

Certain Omarchy installation commands (such as omarchy-install-dev-env) may have installed external utilities like mise, rustup, flatpak, or language runtimes. These tools are not automatically removed when you delete the Omarchy CLI.

You must uninstall third-party tools manually using your system package manager. For example:

# Remove Rust installed via rustup

rustup self uninstall -y

# Remove packages on Arch Linux

sudo pacman -Rns package-name

# Remove packages on Debian/Ubuntu

sudo apt remove package-name

Review which auxiliary tools you installed through Omarchy helpers and remove them individually to avoid orphaned packages.

Update Your Shell Environment

If you added $OMARCHY_PATH/bin to your PATH during installation, remove that line from your shell startup file. Edit ~/.bashrc, ~/.zshrc, or the appropriate rc file for your shell, and delete the export statement referencing Omarchy.

Use this sed command to automate the cleanup:

sed -i '/export PATH=.*omarchy/d' ~/.bashrc

Reload your shell configuration to apply the changes:

source ~/.bashrc

Verify Complete Removal

Confirm that no omarchy commands remain accessible in your shell:

command -v omarchy

This command should produce no output if removal was successful. If it returns a path, repeat the binary deletion step for the specific location shown, then check again.

Summary

• The Omarchy CLI installs as standalone scripts under $OMARCHY_PATH/bin with configuration in ~/.config/omarchy.
• Delete the bin directory to remove all omarchy-* commands, then remove the entire $OMARCHY_PATH tree for shared resources.
• Clear user-specific settings by deleting $HOME/.config/omarchy.
• Third-party tools installed via Omarchy helpers (like rustup or mise) require manual uninstallation through your system package manager.
• Remove the PATH export from your shell rc file and reload your configuration to complete the uninstallation.

Frequently Asked Questions

How do I know where Omarchy is installed on my system?

Run echo "$OMARCHY_PATH" in your terminal. The Omarchy CLI sets this environment variable at runtime to point to either /usr/local/omarchy for system-wide installs or $HOME/.local/omarchy for user-specific installations. This path contains all executable scripts and shared resources.

Will uninstalling Omarchy remove the programming languages it installed?

No, uninstalling the Omarchy CLI only deletes the shell scripts and configuration files. External tools such as rustup, mise, or language runtimes installed via omarchy-install-* commands persist on your system. You must remove these separately using their native uninstallers or your system package manager.

Why does the omarchy command still work after I deleted the files?

If command -v omarchy still returns a path, your shell is caching the executable location or residual files remain. Run hash -r to clear the command hash table, or manually delete the specific path returned by command -v. Also verify you removed the correct $OMARCHY_PATH directory shown by the environment variable.

Is there an automated uninstaller script for Omarchy?

No, the Omarchy repository does not provide an automated uninstaller because the installation is simply a directory of shell scripts. Complete removal requires the manual steps outlined above: deleting $OMARCHY_PATH, clearing ~/.config/omarchy, and cleaning your shell's PATH variable.

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