caflip 0.2.0 → 0.3.1

package/README.md

@@ -2,11 +2,12 @@
 
 A fast account switcher for coding agents like Claude Code and Codex.
 
-![caflip interactive account picker](./docs/demo.png)
+![caflip provider + account interactive flow](./docs/demo.png)
+Pick provider first, then switch account.
 
 caflip is built for one job: if you have multiple Claude or Codex accounts, switch between them quickly.
 
-Today, caflip focuses on Claude Code accounts. Your skills, settings, themes, `CLAUDE.md`, MCP servers, keybindings, and all other configuration stay exactly the same while switching accounts.
+Today, caflip supports both Claude Code and Codex accounts. Your skills, settings, themes, `CLAUDE.md`, MCP servers, keybindings, and all other configuration stay exactly the same while switching accounts.
 
 Use case: you have personal/work Claude or Codex accounts and want to switch quickly without re-login flows every time.
 
@@ -16,7 +17,7 @@ Use case: you have personal/work Claude or Codex accounts and want to switch qui
 | Platform | Credential Storage |
 |---|---|
 | macOS | System Keychain |
-| Linux | `secret-tool` keyring (preferred), file-based fallback (owner-only access) |
+| Linux | `CLAUDE_CONFIG_DIR/.credentials.json` when set, otherwise `~/.claude/.credentials.json`; `secret-tool` is kept as compatibility sync |
 | WSL | Same as Linux |
 | Windows | Not yet supported |
 
@@ -28,6 +29,12 @@ Use case: you have personal/work Claude or Codex accounts and want to switch qui
 curl -fsSL https://raw.githubusercontent.com/LucienLee/caflip/main/install.sh | bash
 ```
 
+To uninstall the standalone binary installed by this script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/LucienLee/caflip/main/uninstall.sh | bash
+```
+
 ### Via npm (Node.js)
 
 ```bash
@@ -40,6 +47,13 @@ npm install -g caflip
 bun install -g caflip
 ```
 
+For package-manager installs, uninstall with the same package manager:
+
+```bash
+npm uninstall -g caflip
+bun remove -g caflip
+```
+
 ### Local Development
 
 ```bash
@@ -49,6 +63,15 @@ bun run dev -- help
 ## Quick Start
 
 ```bash
+# Show current account / managed accounts across both providers
+caflip status
+caflip list
+
+# Pick provider interactively, then add/remove/login
+caflip add
+caflip remove
+caflip login
+
 # Add your first Claude account (must already be logged in)
 caflip claude add --alias personal
 
@@ -69,6 +92,14 @@ caflip claude next
 caflip codex add --alias codex-work
 caflip codex list
 caflip codex next
+
+# Run official provider login through caflip, then register the session
+caflip claude login
+caflip codex login
+
+# Pass provider-specific flags after --
+caflip claude login -- --email lucien@aibor.io --sso
+caflip codex login -- --device-auth
 ```
 
 After switching, restart the target CLI (Claude Code or Codex) to pick up new authentication.
@@ -78,12 +109,18 @@ After switching, restart the target CLI (Claude Code or Codex) to pick up new au
 | Command | Description |
 |---|---|
 | `caflip` | Interactive provider picker (Claude/Codex) |
+| `caflip list` | List managed accounts for Claude and Codex |
+| `caflip status` | Show current account for Claude and Codex |
+| `caflip add [--alias name]` | Pick provider, then add current account |
+| `caflip login [-- <args...>]` | Pick provider, then run provider login and register the resulting session |
+| `caflip remove [email]` | Pick provider, then remove an account |
 | `caflip claude [command]` | Run command for Claude provider |
 | `caflip codex [command]` | Run command for Codex provider |
 | `caflip [provider]` | Interactive account picker for that provider |
 | `caflip [provider] <alias>` | Switch by alias for that provider |
 | `caflip [provider] list` | List managed accounts |
 | `caflip [provider] add [--alias name]` | Add current account |
+| `caflip [provider] login [-- <args...>]` | Run provider login and register the resulting session |
 | `caflip [provider] remove [email]` | Remove an account |
 | `caflip [provider] next` | Rotate to next account |
 | `caflip [provider] status` | Show current account |
@@ -103,7 +140,18 @@ caflip claude alias work hi.lucienlee@gmail.com
 caflip codex alias work me@company.com
 ```
 
-`remove` target accepts email only. Omit it to choose from the interactive picker.
+`add`, `remove`, and `login` can be used without a provider prefix. In that case, caflip asks you to choose Claude or Codex first, then continues the normal command flow.
+
+`remove` target accepts email only. Omit it to choose from the interactive picker after selecting a provider.
+
+`login` can be used without arguments for the default login flow. Pass provider-specific flags after `--`:
+
+```bash
+caflip login
+caflip claude login
+caflip claude login -- --email lucien@aibor.io --sso
+caflip codex login -- --device-auth
+```
 
 ## Shell Prompt Integration
 
@@ -119,6 +167,10 @@ Account data lives in:
 - `~/.caflip-backup/claude/`
 - `~/.caflip-backup/codex/`
 
+On Linux and WSL, caflip follows Claude's config root for active Claude credentials and config:
+- if `CLAUDE_CONFIG_DIR` is set, caflip reads `"$CLAUDE_CONFIG_DIR/.credentials.json"` and `"$CLAUDE_CONFIG_DIR/.claude.json"`
+- otherwise it falls back to `~/.claude/.credentials.json` and then Claude's standard config lookup
+
 ## Credits
 
 Inspired by [cc-account-switcher](https://github.com/ming86/cc-account-switcher).