github SaladDay/cc-switch-cli v5.11.4
CC Switch CLI v5.11.4

one hour ago

CC Switch CLI v5.11.4

This release restores database compatibility with CC Switch desktop v4.0.33 (schema 26), adds managed ChatGPT account selection for Codex, and fixes configuration, proxy, session and terminal issues.

Added

  • Codex / Official Accounts: Select a managed ChatGPT account in the OpenAI Official provider form, or keep the native Codex login. Account activation preserves the previous native login and follows upstream credential ownership and refresh behavior. Includes #550, fixing #547.
  • Sponsors: Add IPWO to the sixth README sponsor position across the English, Chinese and Japanese documentation.

Changed

  • Claude / Configuration Editing: Edit the complete Claude configuration, saving provider fields to the provider record and global settings to the live configuration, with conflict handling for external changes. Legacy Claude common snippets remain readable but are no longer merged at runtime or newly written. Includes #536, addressing #530.
  • Presets / Pricing: Refresh bundled model templates, model capabilities and pricing seeds against upstream. Existing custom prices are preserved; historical built-in prices are repaired only when they still match known defaults. Includes #548.

Fixed

  • Database / Compatibility: Support upstream database schemas 23 through 26 for local startup and WebDAV/S3 restore, including snapshots from CC Switch desktop v4.0.33. Preserve upstream MCP/Skills enablement flags and session parser state through migrations, edits and sync round-trips. Includes #549, fixing #553 and addressing #564.
  • WebDAV / Skills: Preserve each file symlink's own name in skills archives, avoiding duplicate ZIP entries such as CLAUDE.md -> AGENTS.md. Directory cycle detection and outside-root restrictions remain intact. Includes #559.
  • TUI / Terminal Hangup: Exit the Unix TUI when its terminal disconnects, preventing an input polling loop from consuming a CPU core. Normal connected-terminal exits still restore terminal state. Includes #558, fixing #555.
  • Windows / Sessions: Release child lock handles before publishing or retiring session snapshot directories, fixing Access is denied (os error 5) while preserving reader protection. Includes #552, fixing #542.
  • Claude / Proxy Authentication: Use ANTHROPIC_AUTH_TOKEN for ordinary proxy-route placeholders and clear stale ANTHROPIC_API_KEY values, avoiding custom-key confirmation and conflicting credential warnings. Includes #556, fixing #554.
  • Proxy / Responses: Emit response.incomplete for incomplete converted Codex responses and retain their usage and Chat history, so truncated turns are not reported as successful completions. Includes #551, fixing #546.
  • Proxy / Prompt Caching: Keep mid-conversation system messages in their original positions during Anthropic-to-Chat conversion, preserving stable prompt prefixes across turns. Includes #527.
  • Codex / Configuration: Preserve explicit authentication settings and existing bearer credentials when editing provider forms. Omit the unsupported MCP type field from generated Codex TOML. Includes #535 and #512, addressing #532 and #496.
  • Codex OAuth / Quotas: Use the bound account's native quota query for managed OAuth providers and hide the conflicting generic usage-template control in the Claude provider form. Existing automatic and manual refresh behavior is preserved. Includes #534, fixing #533.

Upgrade notes

  • Upgrade all CLI devices and containers before sharing a schema-26 database. CLI v5.11.3 and earlier cannot open it. Existing pre-migration backups remain in place; databases newer than schema 26, including upstream development schema 27, are still rejected.
  • Database compatibility does not add CLI management for Oh My Pi, DeepSeek Harness, GitHub Copilot CLI or WorkBuddy.
  • Managed ChatGPT accounts are not supported by isolated launches (start, TUI temporary launch or --shared-sessions). Switch to the bound official provider first, then run codex.
  • Claude global settings should be edited through the complete configuration editor. Codex and Gemini common-snippet behavior is unchanged. Incomplete Codex responses can now surface a truncation or refusal error instead of silently completing.
  • Run cc-switch update, or use brew upgrade cc-switch-cli for Homebrew installations once the formula is updated.

Thanks

Thank you to everyone who opened an issue or pull request, shared diagnostics, reviewed code, or joined a discussion. The list below covers issues and pull requests active since v5.11.3, including earlier participants in those discussions and commit co-authors. Contributions that remain open or were not merged are included in these thanks, not in the release's feature list.

Contributor Issues and pull requests
@3aKHP #496
@Alemax067 #547
@AloneAtWar #135
@AtaraxiaEpiphany #522
@badcodebuilder #554
@bytemain #467
@claude #551
@CodeCatMeow #403
@cxwx #526
@Cyclonekid #530
@feicai922 #516
@fengyunzaidushi #8, #532
@GalaxyKW #514
@GOTOgxy #564
@hao-lin-lwh #525
@HappyLiang12 #539
@heydryft #545
@Holmestime #8
@jiwei-dot #546
@kelvkhiu #403, #526, #553
@kimjinzhan #562
@laughmaker2024 #555
@lztxwd6666 #563
@RGB-loop #496, #512, #521, #551
@SaladDay #8, #467, #496, #512, #516, #526, #527, #530, #531, #532, #534, #535, #536, #537, #539, #540, #541, #542, #545, #546, #547, #548, #549, #550, #551, #552, #553, #554, #555, #556, #557, #558, #559, #560, #561, #564
@SanAntonio021 #523, #524, #531
@sermady #541
@stan-lei #549, #553
@SunriseOrient #135
@Super-Dian #554
@tao-deng #498
@usufu #540
@Xiao-Maker-droid #527
@xiaoma404 #538
@xuyinkui #8
@ycwfs #537
@zczsyqxl #542, #543
@zydo #403, #533, #534, #544, #548

Thanks also to IPWO and our other sponsors, everyone supporting and using the project, and the CC-Switch maintainers and contributors whose upstream work underpins these improvements.

Install or update

Run cc-switch update, or use brew upgrade cc-switch-cli for Homebrew installations once the formula is updated. Platform packages and the installer are available below:

curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash

Full comparison

What's Changed

  • fix(tui): align managed Codex OAuth quota with upstream by @zydo in #534
  • fix(codex): preserve provider authentication in forms by @SaladDay in #535
  • fix(claude): align configuration editing with upstream by @SaladDay in #536
  • fix(presets): refresh provider model templates to current lineups by @zydo in #548
  • fix(proxy): keep mid-conversation system messages in place for prefix cache by @Xiao-Maker-droid in #527
  • fix(codex): omit unsupported MCP type field from generated TOML by @RGB-loop in #512
  • fix(codex): bind managed ChatGPT accounts to official providers by @SaladDay in #550
  • fix(proxy): emit response.incomplete for incomplete Codex responses by @RGB-loop in #551
  • fix(sessions): allow Windows snapshot publication and cleanup by @SaladDay in #552
  • fix(claude): align proxy placeholder authentication with upstream by @SaladDay in #556
  • fix(database): support upstream schemas 23–26 for sync restore by @stan-lei in #549
  • fix(tui): exit when the input terminal hangs up by @SaladDay in #558
  • fix(webdav-sync): keep file symlink names in skills archives by @SaladDay in #559
  • docs: unify the blind review gate by @SaladDay in #560
  • docs: refine the blind review gate by @SaladDay in #561

New Contributors

Full Changelog: v5.11.3...v5.11.4

Don't miss a new cc-switch-cli release

NewReleases is sending notifications on new releases.