Repository navigation
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.ps1deploys the entry script, cmd adapter, module manifest, completesrc/tree, installer, documentation and an ownership receipt. - Standalone program directory: installs to
%LOCALAPPDATA%\Programs\CodexModeSwitcherby default.CODEX_HOMEis not used as the program directory. - Safe single-file upgrades: a v0.1.0/v0.2.0
codex-mode.ps1is backed up, replaced with a forwarding shim, and restored on uninstall. - Clear repair guidance: missing module files now return
Codex=ModuleMissingwith exact reinstall instructions instead of a rawImport-Moduleexception. - Four lifecycle actions:
Install,Update,VerifyandUninstall, with-DryRun,-Json,-PassThruand 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 -JsonDo 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" StatusThe 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 UninstallUninstall 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.