Skip to content

v0.2.1 — Windows Native Integration

Choose a tag to compare

@styayur styayur released this 12 Oct 01:25
· 9 commits to main since this release
abf8676

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 the codex-mode alias. Original script commands remain available.
  • Windows Terminal: three uniquely identified JSON-fragment profiles: Codex GPT, Codex DeepSeek, Codex Diagnose. Existing settings.json is 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; -Apply is 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 list

Start-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.

PR: #3
Merge commit: abf8676

Uploaded archive SHA-256: 251352ee7ea19754ba01eddd44426c3ab5b9ae820eee4df16ad945cc727a9046. The GitHub-downloaded assets were verified against the merge-commit package.