Repository navigation
v0.2.1 — Windows Native Integration
Windows Native Integration
v0.2.1 adds optional Windows integrations around the Desktop Controller. It also includes the previously unreleased v0.2.0 controller baseline; no separate v0.2.0 release was published.
Features
- PowerShell module:
Import-Module CodexModeSwitcher,Start-CodexMode GPT/DeepSeek,Get-CodexStatus,Test-CodexEnvironment, and thecodex-modealias. Original script commands remain available. - Windows Terminal: three uniquely identified JSON-fragment profiles: Codex GPT, Codex DeepSeek, Codex Diagnose. Existing
settings.jsonis not rewritten. - Start Menu: optional native shortcuts in a dedicated current-user folder. No desktop shortcuts or context-menu registration.
- Integration management: installation/removal preview by default;
-Applyis explicit approval. Ownership/hash checks, list, uninstall-all, backups and conditional failure recovery preserve unowned or edited files. - Optional toast requests: explicit identity installation and per-command
-Notify; fixed outcome messages only. Notification failure never changes a configuration result. - Desktop baseline: validated Windows identity discovery, safe normal-exit coordination, opt-in launch, native GPT model preservation, transactional backups and conditional recovery. No forced Desktop/task termination.
Install
Download CodexModeSwitcher-0.2.1.zip and verify it against SHA256SUMS.txt. The archive contains the complete CodexModeSwitcher/ module folder. Follow module installation and integration instructions.
Import-Module CodexModeSwitcher
Get-CodexStatus
Start-CodexMode GPT -DryRun
codex-mode install terminal # Preview
codex-mode install terminal -Apply # Explicit approval
codex-mode integration listStart-CodexMode launches by default; -ConfigurationOnly opts out. Legacy codex-mode.ps1 GPT remains configuration-only unless -Launch is supplied. Finish tasks and exit Desktop normally before switching. DeepSeek restores the single saved custom provider, not a built-in provider preset. Keep the full distribution; the entry script now depends on src/.
Validation
- Full local, PR, main and v0.2.1 tag CI: 115/115 Pester tests passed, zero failures/skips; PowerShell syntax and PSScriptAnalyzer passed.
- All 89 prior regressions retained; 26 module/integration cases added.
- Native Windows shortcut serialization and AUMID reads exercised only in isolated temporary folders. Desktop activation and toast submission mocked.
- Architecture CI: source/link checks, light/dark rendering and deterministic repeat passed.
- TruffleHog 3.97.9: zero findings in publishable files and committed history, with live credential verification disabled. Private-path patterns clear.
- Archive/manifest validation and cmd failure exit propagation passed. Archive contains only tracked source, excluding original local logs/config/credentials.
Limits and compatibility
- Actual Terminal profile visibility, Start Menu UI launch, visible toast delivery and live Desktop provider E2E remain unverified. Windows policy/Focus Assist may suppress notifications; observing a Desktop process does not prove provider loading.
- No authentication management, session database access, model gateway, GUI, tray or background service. Implicit CLI login/doctor was removed; legacy NoLogin/SkipDoctor flags remain accepted no-ops.
- No guaranteed hot reload or seamless old-session migration. MSIX launch with custom CODEX_HOME remains conservatively blocked.
- Integration updates are not multi-file crash-atomic. Modified/unowned artifacts are preserved; interrupted updates may require local reconciliation. Backups, receipts and empty directories are retained. Legacy profile shortcuts use their separate uninstaller.
- Uninstall integrations before moving/upgrading the distribution, then reinstall from its new location. External editors remain outside the tool's lock.
MIT License. Independent community project, not an official OpenAI or DeepSeek product.
Uploaded archive SHA-256: 251352ee7ea19754ba01eddd44426c3ab5b9ae820eee4df16ad945cc727a9046. The GitHub-downloaded assets were verified against the merge-commit package.