docs: bring the wiki up to v0.2.1 Install from the cask or DMG with the setup window, update and uninstall from the app, the API credit fallback and dead-key notes, a Remote tasks page, the Codex/ChatGPT tab, card menus, Settings' General/Automation/Remote sections, and the widget shipping in the app. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs: document ChatGPT switching gate and capability check Switching stays off until Enable ChatGPT switching. Suggestions stay disabled until that parent is on. Compatible signed updates can switch; known-incompatible builds are refused without an exact version pin.
docs: keep wiki ChatGPT flow on shipped extra Describe confirmed desktop restart and suggestions as they work on main. Leave parent capability gating to the in-repo docs until that branch merges.
docs: align wiki with current extra, Codex, and ChatGPT switching Drop the asterisk/Advanced settings, document General vs Automation, Codex CLI, kickoff plan gating, and experimental ChatGPT desktop switching (off by default, capability probe, confirmed restart).
Menu bar: confirm before switching, rename from More, icon fallback
Install with install.sh and openswap setup
docs: opt-in status line wraps the user's command Account name goes on the percentage row. Off until openswap statusline --install.
docs: plain English; signing details stay in repo docs Product name is OpenSwap, command is openswap. Drop appex/launchd/ WidgetKit/CLAUDE_CONFIG_DIR from user pages. Team-pick order lives in docs/widget.md. List openswap upgrade on the CLI page.
docs: Settings in popover; OpenSwap path; gone verbs Settings is a page in the extra, not More. Snapshot path is ~/Library/Application Support/OpenSwap/. Tombstone for tui/watch/run/map/unmap.
docs: three settings files, not two settings.json is shared policy (openswap config). menubar_settings.json is extra display and kickoff. autoswitch_state.json is engine runtime.
docs: openswap upgrade uses uv tool install --force
docs: openswap upgrade is git pull plus editable reinstall
docs: export/import is CLI, not extra More The extra does not export. Point the Features row at openswap export / import.
docs: drop advertised self-upgrade from CLI reference openswap upgrade is not a PyPI self-upgrade. Keep git pull in Getting-Started.
cut: session mode and directory maps are gone openswap run / map / unmap are not shipped. Switch with the extra or openswap list / switch. Isolated profiles remain for idle 5h kickoff.
docs: the terminal dashboard is gone Use the extra, widget, or openswap list. Bare openswap prints help.
docs: macOS product; API-key slots are switch-only
docs: drop fork wording from Features
docs: rebrand the wiki to OpenSwap
Document widget Edit Widget layouts and combined remaining.
Document signed-out extra cards and click-to-repair. The extra now shows signed-out on the card, opens Claude login when needed, and only captures when the live login matches that slot.
docs: extra title 5h and 7d percents are separate toggles
docs: nested extra settings only appear when the parent is on
docs: auto-switch threshold and strategy only show when enabled
docs: kickoff time is an hourly menu, not Change
docs: org names, soonest-5h, in-popover settings, widget tap
docs: popover click, leave-delay close, and extra cooldown Card clicks start the auto-switch cooldown. More keeps the box open. The popover stays while you look and closes after the pointer leaves.
docs: user guide for every cswap feature Install, accounts, auto-switch, sessions, menu bar, widget, 5-hour kickoff, configuration, backup, troubleshooting, and a features index.
Initial Home page