Skip to content

v0.2.2 — Installer and Upgrade Recovery

Latest

Choose a tag to compare

@styayur styayur released this 19 Oct 15:46
· 6 commits to main since this release
3439265

Installation and upgrade fix

v0.2.2 fixes the v0.2.1 delivery failure where updating only ~/.codex/codex-mode.ps1 left the entry point without src/CodexMode.psm1 and every command failed to import the module.

Highlights

  • Complete installer: install.ps1 deploys the entry script, cmd adapter, module manifest, complete src/ tree, installer, documentation and an ownership receipt.
  • Standalone program directory: installs to %LOCALAPPDATA%\Programs\CodexModeSwitcher by default. CODEX_HOME is not used as the program directory.
  • Safe single-file upgrades: a v0.1.0/v0.2.0 codex-mode.ps1 is backed up, replaced with a forwarding shim, and restored on uninstall.
  • Clear repair guidance: missing module files now return Codex=ModuleMissing with exact reinstall instructions instead of a raw Import-Module exception.
  • Four lifecycle actions: Install, Update, Verify and Uninstall, with -DryRun, -Json, -PassThru and staged replacement.
  • Release integrity: the archive includes release-manifest.json; CI verifies the complete payload, every SHA-256 and module import, and rejects entry-only delivery.

Install

Download the complete CodexModeSwitcher-0.2.2.zip archive, verify it against SHA256SUMS.txt, extract it, then run:

pwsh -NoProfile -File .\CodexModeSwitcher\install.ps1 -Action Install
& "$env:LOCALAPPDATA\Programs\CodexModeSwitcher\codex-mode.ps1" Diagnose -Json

Do not download only codex-mode.ps1; it depends on the full distribution.

Upgrade from v0.1.0 or v0.2.0

pwsh -NoProfile -File .\CodexModeSwitcher\install.ps1 -Action Install
& "$env:CODEX_HOME\codex-mode.ps1" Status

The installer backs up the existing entry before installing the forwarding shim. Existing configuration, credentials, sessions, state and backups under CODEX_HOME are not modified.

Verify and uninstall

pwsh -NoProfile -File .\CodexModeSwitcher\install.ps1 -Action Verify
pwsh -NoProfile -File .\CodexModeSwitcher\install.ps1 -Action Uninstall

Uninstall removes program-owned files and shims, restores verified legacy entries, and preserves Codex user data. Optional Terminal/Start Menu/notification integrations remain separate and should be removed with codex-mode integration uninstall-all -Apply.

Validation

  • PR #5: merged at 3439265f8a445e628ed2ea80ae6535dda24f87d7.
  • CI: push run and PR run: 125/125 Pester tests passed, syntax and PSScriptAnalyzer clean, release archive built and verified.
  • Architecture verification: passed.
  • Installed from the built release archive, verified with -Action Verify, and uninstalled from the installed copy.

Assets

  • CodexModeSwitcher-0.2.2.zip — complete installable distribution.
  • SHA256SUMS.txt — SHA-256 for the archive and manifest.
  • release-manifest.json — per-file SHA-256 and size for the installable payload.

Archive SHA-256: fa6d836bed4de1e5b9f02b80f33367ba9021c8ec20cf08b7d554325bf52b9bb5

No GUI, resident service, tray agent, PATH/PSModulePath change or registry-based integration is added. Live Desktop provider end-to-end verification remains a manual acceptance item, unchanged from v0.2.1.