@youdie006/swapdex 0.155.0 → 0.158.0

package/README.md

@@ -148,15 +148,27 @@ so it can't be logged out), `swapdex restore` undoes the last swap, and `swapdex
 ui` is the full-screen picker. `swapdex migrate` matches Claude and Codex
 profiles to slots by account and creates spaces only for accounts without one.
 
-`status` shows the live account per tool, matched back to a saved profile:
+`status` shows the active account per tool, matched back to a saved profile:
 
 ```
 claude-code: you@work.com [max] (profile 'work')
 codex: you@personal.com [chatgpt] (profile 'personal')
 ```
 
-The active account is always read from the **live** login, so if you `/login`
-directly in the CLI, swapdex reports the truth rather than a stale guess.
+The active account is read from the **pointer** a switch sets, and falls back
+to the live login on a machine that has no slots. Where the tool's own config
+dir holds a different account -- you signed in directly without the shim, or an
+old copy-model switch left one behind -- that gets its own line rather than
+being shown as the active account:
+
+```
+codex: you@work.com (profile 'work')
+  (a plain `codex` would launch on 'personal' instead - `swapdex shim`
+   makes it follow your switches)
+```
+
+Both are true and they answer different questions, so swapdex prints both
+instead of picking one. A machine sat in exactly that state for six days.
 
 For your shell prompt or statusline, `status --short` prints one compact line:
 
@@ -228,6 +240,36 @@ setup is one keystroke and a name.
 <img src="https://raw.githubusercontent.com/youdie006/swapdex/main/docs/ui-demo.gif" alt="swapdex ui on a fresh machine: it finds the Claude Code and Codex logins already present, saves them as a profile named main, and shows the account with its 5h and 7d usage bars" width="760" />
 </div>
 
+## Keeping accounts from expiring
+
+An account nobody opens dies on its own. These refresh tokens go stale when
+they are not exercised -- measured across two machines, an idle Codex slot
+stops working about ten days after its last run -- and once the refresh token
+is gone only a browser sign-in brings the account back.
+
+swapdex renews idle accounts for you, but **only while its proxy is running**,
+because that is the process holding the timer:
+
+```sh
+swapdex service install --tool claude
+swapdex service install --tool codex
+```
+
+That installs a launchd/systemd unit per tool. The proxy then sweeps every
+thirty minutes and renews anything approaching its deadline, including slots
+nobody has opened. A slot the tool is running in is never touched: its own
+session holds the refresh token, and renewing from outside would retire the one
+that session is about to use.
+
+Without the service, nothing is on a timer. You can sweep by hand:
+
+```sh
+swapdex refresh --keep-alive     # renew every account heading for expiry
+swapdex refresh <name>           # renew one that has already lapsed
+```
+
+`swapdex doctor` reports whether the service is installed and running.
+
 ## How it works
 
 **Slots (the model swapdex uses now).** Each account gets its own
@@ -280,6 +322,16 @@ their own slots, retiring the shared homes.
 like `~/.ssh`, and do not sync it across machines (it is single-machine,
 single-user by design).
 
+**Do not copy a credential out of the store for something else to use.** These
+refresh tokens are single-use: the server retires the outgoing one whenever a
+holder renews, so two programs holding one account's credential silently
+retire each other's. The copy that missed a renewal keeps working until its
+access token lapses, which is why the failure arrives hours or days after the
+change that caused it -- one such split cost a scheduled job 42 hours. A
+program that needs its own Codex or Claude access should sign in for itself;
+`swapdex` is for accounts a person switches between, not a credential source
+for other software.
+
 ### What it will not do
 
 These are structural properties, not promises -- the code is built so they

package/man/swapdex.1

@@ -1,6 +1,6 @@
 .ie \n(.g .ds Aq \(aq
 .el .ds Aq '
-.TH swapdex 1  "swapdex 0.155.0" 
+.TH swapdex 1  "swapdex 0.158.0" 
 .SH NAME
 swapdex \- Switch Claude Code / Codex / Gemini / Antigravity login accounts, locally and safely.
 .SH SYNOPSIS
@@ -23,7 +23,7 @@ swapdex\-use(1)
 Switch the active login to a saved profile
 .TP
 swapdex\-run(1)
-Launch Claude in an account\*(Aqs own permanent slot (concurrent\-safe)
+Launch a tool in an account\*(Aqs own permanent slot (concurrent\-safe)
 .TP
 swapdex\-whereis(1)
 Find which account holds a conversation (searches every account\*(Aqs store)
@@ -41,7 +41,7 @@ swapdex\-slots(1)
 List the permanent account slots
 .TP
 swapdex\-shim(1)
-Install the `claude` shim so a plain `claude` follows `swapdex use`
+Install the shims so a plain `claude` or `codex` follows `swapdex use`
 .TP
 swapdex\-adopt(1)
 Register an existing CLAUDE_CONFIG_DIR directory as a slot (in place)
@@ -56,11 +56,17 @@ swapdex\-sync\-mcp(1)
 Share MCP servers (from ~/.claude.json) into every account slot
 .TP
 swapdex\-ls(1)
-List saved profiles (active marked from the live login)
+List accounts, marking the one each tool is pointed at
 .TP
 swapdex\-status(1)
 Show the active account per tool
 .TP
+swapdex\-pause(1)
+Keep an account out of the proxy\*(Aqs AUTOMATIC rotation (`use`/`serve` still work)
+.TP
+swapdex\-resume(1)
+Put a paused account back in rotation
+.TP
 swapdex\-rm(1)
 Remove a saved profile (never touches a live login)
 .TP
@@ -89,7 +95,7 @@ swapdex\-share\-history(1)
 Make every conversation reachable from every account (one\-time repair)
 .TP
 swapdex\-slash(1)
-Install a `/sx` slash command for Claude Code (switch without leaving the chat)
+Install a `/swap` command for Claude Code and Codex (switch inside the chat)
 .TP
 swapdex\-threshold(1)
 Step off an account at this much used (e.g. 0.9 or 90%), or `off`
@@ -130,4 +136,4 @@ Print the man page (roff) to stdout
 swapdex\-help(1)
 Print this message or the help of the given subcommand(s)
 .SH VERSION
-v0.155.0
+v0.158.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdie006/swapdex",
-  "version": "0.155.0",
+  "version": "0.158.0",
   "description": "Switch between multiple Claude Code, Codex, Gemini, and Antigravity login accounts, locally and safely.",
   "bin": {
     "swapdex": "bin/swapdex.js"
@@ -12,10 +12,10 @@
     "man/swapdex.1"
   ],
   "optionalDependencies": {
-    "@youdie006/swapdex-darwin-arm64": "0.155.0",
-    "@youdie006/swapdex-darwin-x64": "0.155.0",
-    "@youdie006/swapdex-linux-x64": "0.155.0",
-    "@youdie006/swapdex-linux-arm64": "0.155.0"
+    "@youdie006/swapdex-darwin-arm64": "0.158.0",
+    "@youdie006/swapdex-darwin-x64": "0.158.0",
+    "@youdie006/swapdex-linux-x64": "0.158.0",
+    "@youdie006/swapdex-linux-arm64": "0.158.0"
   },
   "keywords": [
     "cli",