Skip to content

Add legacy migration guides and cleanup tools - #72

Merged
masahide merged 1 commit into
mainfrom
codex/legacy-migration-guide
Jul 20, 2026
Merged

Add legacy migration guides and cleanup tools#72
masahide merged 1 commit into
mainfrom
codex/legacy-migration-guide

Conversation

@masahide

Copy link
Copy Markdown
Owner

Summary

  • add a prominent README notice for users upgrading from legacy OmniSSHAgent
  • add the redesign background and a complete migration guide
  • add a read-only Windows diagnostic for legacy settings, key references, credentials, services, autostart, sockets, and optional WSL inspection
  • add a curl-executable WSL2 legacy proxy uninstaller with --dry-run, exact executable matching, process shutdown, profile backups, and path-restricted cleanup
  • move planning and requirements documents under docs/
  • remove the obsolete examples/ tray sample
  • keep signing notifications as a reserved future feature and remove the non-functional tray toggle

WSL2 uninstall

Preview:

curl -fsSL https://raw.githubusercontent.com/masahide/OmniSSHAgent/main/scripts/uninstall-legacy-wsl2.sh |
  sh -s -- --dry-run

Apply after merge:

curl -fsSL https://raw.githubusercontent.com/masahide/OmniSSHAgent/main/scripts/uninstall-legacy-wsl2.sh |
  sh

The script stops only $HOME/wsl2-ssh-agent-proxy/wsl2-ssh-agent-proxy, waits for TERM before KILL, backs up affected shell profiles, and removes only the dedicated proxy directory and socket.

Validation

  • go test ./...
  • go vet ./...
  • PowerShell 5.1 parse and execution of scripts/check-legacy-install.ps1
  • static check that the Windows diagnostic contains no mutating commands
  • bash -n scripts/uninstall-legacy-wsl2.sh
  • isolated-home --dry-run through Git for Windows Bash
  • stale doc/ and deleted examples/ reference checks
  • git diff --check

@masahide
masahide marked this pull request as ready for review July 20, 2026 13:21
@masahide
masahide merged commit c649d12 into main Jul 20, 2026
1 check passed
@masahide
masahide deleted the codex/legacy-migration-guide branch July 20, 2026 13:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant