CC Switch CLI v5.11.0

CC Switch CLI v5.11.0

This release adds Codex reset-credit commands and improves database, authentication, proxy, and OpenCode compatibility.

Added

• Codex / Reset Credits: Inspect and redeem rate-limit reset credits from auth and provider quota commands. Confirmation commands pin the selected managed account and credit; inspection failures are distinguished from empty results, and a failed refresh after redemption does not invite a second redemption. Includes #475 and #477.

Changed

• Database / Compatibility: Align schema and migrations with CC-Switch schema v20, including shared MCP/Skills fields. Databases at v18 and v19 migrate forward; v20 databases work with local startup and SQL/WebDAV import. Includes #484, addressing #472.
• Codex / Configuration and Authentication: Align provider switching, native-login preservation, configuration projection, and interrupted-write recovery with the shared implementation. Third-party keys are written to the provider's TOML bearer token, and switching back to OpenAI Official restores the native login without retaining the third-party key. Includes #486, addressing #480 and #473.
• OpenCode / V2 Storage: Support OpenCode 2.x session and message tables for session browsing, transcripts, deletion, and usage collection, while retaining V1 support and handling mixed databases. Includes #485, fixing #483.

Fixed

• Codex / Compressed Requests: Decode compressed Codex requests before proxy processing. Includes #487, fixing #469.
• Codex / Tool Declarations: Collect supported additional_tools declarations from input carriers for Chat Completions conversion. Includes #488, fixing #466.
• Codex / Reasoning and Tools: Preserve reasoning across mixed tool-call turns and combine commentary with tool output where required by the conversion path. Includes #491, fixing #458.
• Codex / OAuth Identity: Use consistent Codex client identity headers for OAuth requests and model discovery, matching client version 0.159.0. Includes #465.
• Proxy / Empty Legacy Tool Calls: Ignore legacy function_call payloads in Chat-to-Anthropic streaming, preventing empty placeholders from creating invalid tool blocks. Includes #438, addressing #437. See the compatibility note below.
• Hermes / Custom Home: Honor custom Hermes home directories. Includes #489, fixing #464.
• Configuration / Symlinked Home: Support symlinked home-directory ancestors, including Synology layouts, while retaining protections for managed paths. Includes #490, fixing #457.
• TUI / Build Reliability: Prevent visibility sentinel functions from being folded together. Includes #462.
• Tests / Portability: Handle the single-parser-worker completion-order case and skip the non-UTF8 filename case on macOS. Includes #470 and #463.

Upgrade notes

• Database schema advances from v18 to v20. Back up your configuration before upgrading; older clients that only support v18 cannot open a migrated database. Schema versions newer than v20 remain rejected.
• Normal Codex provider switching preserves live settings and MCP configuration rather than replaying saved common snippets or resynchronizing MCP. Explicit common-config editing remains available.
• Streamed tool invocations must use modern tool_calls. Legacy-only function_call payloads are now ignored, including nonempty payloads; the existing finish-reason mapping is retained. See the compatibility details.
• For Homebrew installations, use brew upgrade cc-switch-cli.

Thanks

Thank you to everyone who reported problems, proposed changes, shared diagnostics, reviewed code, or joined the discussions. The list below covers issues and pull requests active since v5.10.5 and their linked discussions, including earlier participants and contributions that have not been merged. Being listed here does not mean a proposed feature is included in this release.

Contributor	Issues and pull requests
@1753135250	#252
@525300887039	#476
@alario-tang	#472
@bryango	#462, #463, #470
@bytemain	#467, #475, #477
@CCE-Li	#130
@CodeCatMeow	#403
@cyberElar	#468, #469
@Devin-Pi	#358, #446
@dividduang	#358
@GOTOgxy	#472
@haai-team	#130
@HappyLiang12	#466
@JM-FRANK	#478
@Josh00-Lu	#473
@JounQin	#457
@kelvkhiu	#403, #444, #474, #479
@kiwiflydream	#334
@l2yyd5	#472
@LJY-emperor	#480
@MainRedstoner	#482
@MALossov	#472
@moonjoke001	#358
@msuadOf	#130
@neverdie0710	#451
@qiufuyu123	#465
@RainyPixel	#449
@RuoChen5251	#471
@ruolin1314	#483
@Sakulakime	#472
@SaladDay	#334, #358, #434, #438, #444, #446, #449, #451, #457, #458, #461, #462, #463, #464, #465, #466, #467, #468, #469, #470, #471, #472, #473, #475, #476, #477, #478, #479, #480, #484, #485, #486, #487, #488, #489, #490, #491
@SoFarSoGoodya	#334
@suntory1	#358
@SyaJask	#358
@tangjunyi1	#458
@tianzhuwei	#358
@tony	#434
@Tonystarkw12	#434
@u1544096979	#437, #438
@unive3sal	#130
@wangsiqidahaoren	#461
@ybin2024	#464
@zhiquanchi	#130

Thanks also to the CC-Switch maintainers and contributors whose shared implementations underpin the compatibility fixes in this release.

Install or update

For Homebrew installations, run brew upgrade cc-switch-cli once the formula is updated. Otherwise, use the platform packages below or the installer:

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

Full comparison

What's Changed

• test(skills): skip non-UTF8 filename test on macOS by @bryango in #463
• fix(tui): preserve help sentinel identity in optimized builds by @bryango in #462
• feat(auth): support Codex rate limit reset credits in quota inspection and consumption by @bytemain in #475
• tests: fix completion-order test with a single parser worker by @bryango in #470
• fix(database): align schema and migrations with upstream v20 by @SaladDay in #484
• fix(opencode): port upstream V2 usage and session support by @SaladDay in #485
• fix(codex): align provider switching and auth with upstream by @SaladDay in #486
• fix(proxy): support compressed Codex requests by @SaladDay in #487
• fix(codex): preserve additional_tools declarations in proxy conversion by @SaladDay in #488
• fix(hermes): honor custom Hermes home directories by @SaladDay in #489
• fix(config): support symlinked home directory ancestors by @SaladDay in #490
• fix(codex): preserve reasoning across mixed tool-call turns by @SaladDay in #491
• fix(codex): align OAuth client identity for GPT-6 by @qiufuyu123 in #465
• fix: pin quota reset targets and distinguish inspection failures by @bytemain in #477
• fix(proxy): ignore empty legacy function_call placeholders by @u1544096979 in #438
• chore(release): prepare v5.11.0 by @SaladDay in #492

New Contributors

• @bryango made their first contribution in #463
• @bytemain made their first contribution in #475
• @qiufuyu123 made their first contribution in #465
• @u1544096979 made their first contribution in #438

Full Changelog: v5.10.5...v5.11.0