Uninstall

Remove shell hook

Remove the tirith init hook line from your shell config:

Shell	Config file
zsh	~/.zshrc
bash	~/.bashrc
fish	~/.config/fish/config.fish
PowerShell	$PROFILE

Remove AI-agent integrations

Before removing the binary, remove the Tirith-owned hook, plugin, MCP, or gateway entry from every host configured with tirith setup. Setup preserves unrelated host settings and may create a sibling backup when it changes an existing file; do not delete an entire shared host configuration directory.

There is not yet a universal tirith setup --uninstall operation because the 19 hosts use different ownership and merge contracts. Use the agent integration matrix to locate the exact user/project artifacts for Claude Code, Cline, Codex, GitHub Copilot CLI, Continue, Cursor, fx, Gemini CLI, Grok Build, Kiro, OMP, OpenClaw, OpenCode, OpenHands, Pi CLI, Prime Agent, Roo Code, VS Code, and Windsurf. Restart the host after removing its Tirith entry, then run tirith doctor while Tirith is still installed to check for any remaining effective integration.

Remove binary

Homebrew

brew uninstall tirith

npm

npm uninstall -g tirith

Cargo

cargo uninstall tirith

Scoop (Windows)

scoop uninstall tirith

Chocolatey (Windows)

choco uninstall tirith

AUR (Arch Linux)

pacman -Rns tirith
# or: yay -Rns tirith
# or: paru -Rns tirith

Debian / Ubuntu (.deb)

sudo dpkg -r tirith

Fedora / RHEL / CentOS (.rpm)

sudo dnf remove tirith
# or for older systems: sudo yum remove tirith

Shell script install

rm ~/.local/bin/tirith
sudo rm -f /usr/local/libexec/tirith-package-approval-authority
sudo rm -f /usr/local/libexec/tirith-package-approval-authority.tirith-previous
sudo rm -f /usr/local/libexec/tirith-package-approval-authority.tirith-previous.absent

Nix

If installed via nix profile install:

nix profile remove github:sheeki03/tirith

Note: nix run doesn't install anything permanently.

Docker

docker rmi ghcr.io/sheeki03/tirith

asdf

asdf uninstall tirith
asdf plugin remove tirith

Oh-My-Zsh plugin

Remove tirith from the plugins list in ~/.zshrc, then:

rm -rf ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/tirith

Manual

Delete the tirith binary from your PATH. On x86_64 Linux, also remove the matching root-owned helper if it was installed manually:

sudo rm -f /usr/local/libexec/tirith-package-approval-authority
sudo rm -f /usr/local/libexec/tirith-package-approval-authority.tirith-previous
sudo rm -f /usr/local/libexec/tirith-package-approval-authority.tirith-previous.absent

Remove data

tirith stores data in XDG-compliant directories:

# Remove config (policy, allowlist, blocklist)
rm -rf ~/.config/tirith

# Remove data (audit log, receipts, materialized hooks, last_trigger)
rm -rf ~/.local/share/tirith

# Optional: remove native package-approval keys after all Tirith installs are gone
sudo rm -rf /etc/tirith/package-approval

On macOS:

rm -rf ~/Library/Application\ Support/tirith
rm -rf ~/Library/Preferences/tirith

On Windows:

Remove-Item -Recurse "$env:LOCALAPPDATA\tirith"
Remove-Item -Recurse "$env:APPDATA\tirith"