Features

Features

Everything this fork adds on top of upstream claude-swap, plus the core CLI you already get.

Core (CLI and TUI)

Feature	Where	Notes
Save and switch Claude Code logins	cswap add, cswap switch	Does not log you out
5-hour and 7-day usage	cswap list, TUI, extra, widget	Same numbers everywhere
Per-model weekly limits (Fable, …)	cswap list, popover, title option	Fold into auto-switch with autoswitch.model
Auto-rotate near a limit	cswap auto, extra Settings	Shared engine and settings.json
best strategy	default	Stay until ~90%, then most quota left
consume-first strategy	Settings or cswap config	Soonest weekly reset (use-it-or-lose-it)
Parallel accounts	cswap run	This terminal only
Directory maps	cswap map	Bare cswap run in a repo picks the account
Aliases, disable, export/import	CLI and extra More menu	Disable keeps the login, skips rotation
JSON for scripts	--json	auto --json is an event stream

Guides: Getting started · Accounts · Auto-switch · Sessions · CLI reference

macOS extra

Feature	Where	Notes
Usage popover	Click the extra	Bars, percent, time until reset. Stays while you look; closes ~12s after the pointer leaves
Click a card to switch	Popover	First click counts. Starts the auto-switch cooldown so the engine does not snap back
Auto-switch control	Top-right of the popover	More keeps the box open
Dark Mode	System Settings → Appearance	Popover, not the menu bar wallpaper tint
Compact title	Asterisk off (default)	No empty gap on the left of the extra
Optional ✻	More → Advanced	Off by default
Title: name, 5h, 7d, Fable	More → Settings
Auto-switch from the extra	More → Settings	Same engine as cswap auto
Strategy picker	More → Settings	Most quota left / soonest weekly reset
Notifications	System	Switch, quarantine, exhausted, kickoff
Remember position	Cmd-drag	Autosave name com.cswap.menubar
Start at login	cswap menubar --install-service	launchd, no .app

Guide: Menu bar

Desktop widget

Feature	Where	Notes
Small / medium / large	Notification Center and Desktop	Active account, up to 3, up to 6
Live countdown	WidgetKit timeline	Extra writes a snapshot JSON
Dark Mode	System appearance / wallpaper	Dynamic colors
Signed host + appex	cswap widget --install	Needs this git checkout and Xcode

Guide: Desktop widget

5-hour kickoff

Feature	Where	Notes
Open idle 5h windows on a schedule	More → Settings → Start 5-hour window	Local clock, once per day
Does not change default login		Live login pinged in place
Skips API keys and open windows		Stale yesterday rows are pinged

The time you set is the start, not “9:00 minus 5 hours.” Guide: 5-hour kickoff

Not in this fork (yet)

• Placing the extra next to Claude’s extra automatically (Cmd-drag it)
• Placing the widget automatically (Edit Widgets → cswap)
• A cswap kickoff CLI command (kickoff is extra-only)