Skip to content

Add gortex uninstall and gortex upgrade commands (especially for Windows) #298

Description

@sysin1

Summary

It would be helpful if Gortex provided first-class support for uninstalling and upgrading itself, particularly on Windows.

Currently installation is straightforward, but there doesn't appear to be an official uninstall process documented or built into the CLI.

Problems

  • Users must manually determine which files were installed.
  • AI tool integrations (Claude, Gemini, Cursor, etc.) may leave configuration behind.
  • Windows users have to manually remove binaries, services, and configuration folders.
  • Upgrading currently requires reinstalling, with no cleanup or rollback.

Proposed solution

Add two commands:

gortex uninstall

The command should:

  • Stop the daemon if running
  • Remove the Windows service (or systemd/launchd service)
  • Remove the installed executable
  • Remove Gortex configuration
  • Remove cache/data (optional via --purge)
  • Remove AI integrations that were installed by gortex install
  • Restore backed-up configuration files when possible
  • Ask for confirmation before destructive actions

Example:

gortex uninstall

or

gortex uninstall --purge


gortex upgrade

The command should:

  • Detect the latest release
  • Download the correct binary
  • Verify checksum/signature
  • Stop the daemon
  • Replace the executable
  • Restart the daemon
  • Preserve existing configuration
  • Roll back if the upgrade fails

Example:

gortex upgrade


Windows

On Windows it would also be useful to:

  • Support uninstall from PowerShell
  • Register with "Apps & Features"
  • Support winget upgrade/uninstall
  • Cleanly remove services and PATH entries
  • Remove Start Menu shortcuts (if created)

Benefits

  • Easier maintenance
  • Cleaner removal
  • Better enterprise deployment
  • Simpler CI/CD automation
  • More consistent user experience across platforms

Metadata

Metadata

Assignees

Labels

User feedbackImplementation is ready, feedback awaitedenhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions