Skip to content

jcjc-dev/cli-uninstaller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧹 CLI Uninstaller

Nightly Validation

You can finally clean up coding agents you downloaded without using a package manager.

🚀 Get Started

CLI Uninstaller removes coding-agent CLIs installed by custom shell scripts like curl ... | bash and irm ... | iex. It intentionally skips tools installed through npm, pipx, Homebrew, WinGet, or other package managers.

🧽 Uninstall

Choose your tool and platform, then copy one command.

🤖 Junie CLI

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- junie

Windows PowerShell:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.ps1))) junie

🤖 GitHub Copilot CLI

macOS / Linux custom installer:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- copilot-cli

Windows:

Native Windows installs are managed by WinGet and are intentionally out of scope for this repo.

🤖 Claude Code

macOS / Linux native installer:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- claude-code

Windows PowerShell native installer:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.ps1))) claude-code

🤖 OpenCode

macOS / Linux custom installer:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- opencode

Windows Git Bash / MSYS2 / Cygwin:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- opencode

⚙️ Options

By default, scripts remove install artifacts only. User data is kept.

To also remove user data, add --purge on macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.sh | bash -s -- junie --purge

On Windows PowerShell, add -Purge:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/jcjc-dev/cli-uninstaller/main/uninstall.ps1))) junie -Purge

Use --yes or -Yes only when the caller has already confirmed that deleting install artifacts without prompts is intended.

🎯 What This Covers

Verified tools:

  • JetBrains Junie CLI
  • GitHub Copilot CLI
  • Claude Code native installer
  • OpenCode script installer

Not covered:

  • npm, npx, pnpm, Yarn, pipx, Homebrew, WinGet, apt, dnf, pacman, or other package-manager installs
  • wrappers that simply call a package manager
  • IDE extensions and marketplace installs

Platforms:

  • macOS and Linux: Bash scripts under scripts/ plus the uninstall.sh dispatcher.
  • Windows PowerShell: supported for tools with native script installers, currently Junie CLI and Claude Code.
  • Windows Git Bash / MSYS2 / Cygwin: supported for tools whose upstream installer uses Bash-compatible Windows paths, currently OpenCode.

Windows package-manager installs are still out of scope. For example, GitHub Copilot CLI's native Windows installer uses WinGet, so uninstall it with winget uninstall GitHub.Copilot.

🛡️ Safety Model

Each script separates:

  • install artifacts: binaries, shims, version directories, update payloads
  • user data: auth state, settings, conversations, transcripts, permissions, logs, skills, hooks, allowlists, and caches

Default uninstall removes install artifacts only. User data is kept unless --purge is provided, and interactive runs ask before deleting each user-data path.

Shared shell profile changes are not edited automatically. Installers commonly add ~/.local/bin or another bin directory to PATH, but that path is often shared by many tools.

📦 Manifests

The manifests/ directory records installer commands, install artifacts, user-data paths, and notes for each supported tool. Scripts should stay aligned with their corresponding manifest.

📄 License

MIT. See LICENSE.

About

Clean up coding agents downloaded without using a package manager

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors