@hasna/accounts 0.1.4 → 0.1.6

package/README.md

@@ -1,8 +1,8 @@
 # @hasna/accounts
 
 > Manage and switch between multiple AI coding tool profiles/accounts on one
-> machine — Claude Code, Codex CLI, opencode, Cursor Agent, Kimi Code, Grok
-> Build, and custom tools.
+> machine — Claude Code, Takumi, Codex CLI, Gemini CLI, opencode, Cursor
+> Agent, Pi Coding Agent, Hermes, Kimi Code, Grok Build, and custom tools.
 
 `accounts` is a local-first CLI. Each **profile** is an isolated config directory.
 Switch **in the terminal** with `CLAUDE_CONFIG_DIR`, or **in Cursor / VS Code** with
@@ -11,8 +11,9 @@ Switch **in the terminal** with `CLAUDE_CONFIG_DIR`, or **in Cursor / VS Code**
 - **Isolated profiles** — separate config dirs (skills, settings, sessions). Nothing leaks.
 - **Apply mode** — sync OAuth / credentials to live paths for IDEs (Claude-only today).
 - **Remembers the email** — auto-detected from `.claude.json` when possible.
-- **Multi-tool** — first-class built-ins for Claude, Codex, opencode, Cursor Agent,
-  Kimi Code, and Grok Build; custom tools via `accounts tools add`.
+- **Multi-tool** — first-class built-ins for Claude, Takumi, Codex, Gemini,
+  opencode, Cursor Agent, Pi, Hermes, Kimi Code, and Grok Build; custom tools
+  via `accounts tools add`.
 - **Per-tool names** — `work` can exist for Claude, Codex, Cursor, etc.; pass
   `--tool` when a bare profile name is ambiguous.
 - **Local-first** — registry at `~/.hasna/accounts/`. No network, no telemetry.
@@ -47,6 +48,11 @@ accounts apply personal
 # Or terminal-only (parallel sessions OK):
 accounts launch work --tool claude
 eval "$(accounts env personal --tool claude)"   # other terminal
+
+# Or supervised: lets MCP switch/restart this Claude process automatically
+accounts use work --tool claude
+accounts run claude --resume
+accounts switch personal --tool claude --supervisor   # from another terminal
 ```
 
 After `accounts login <name> --tool claude`, `accounts` snapshots the auth Claude
@@ -92,6 +98,7 @@ Implementation details: [docs/IMPLEMENT.md](docs/IMPLEMENT.md).
 | `accounts apply <name> --tool claude` | Apply profile auth to live Claude paths (requires snapshot; Claude-only). |
 | `accounts pick` | Interactive picker; default applies. `--env`, `--no-act`. |
 | `accounts switch <name> --tool <tool>` | Switch profile and print a restart/resume command. Add `--resume`; add `--launch` to run it. |
+| `accounts switch <name> --tool <tool> --supervisor` | Ask a running `accounts run <tool>` supervisor to restart under that profile. |
 | `accounts use <name> --tool <tool>` | Mark profile active; prints apply/env hints. |
 | `accounts list` (`ls`) | List profiles (`●` active, `◉` applied, `●◉` both). |
 | `accounts show <name> --tool <tool>` | Profile details including active/applied flags. |
@@ -99,7 +106,11 @@ Implementation details: [docs/IMPLEMENT.md](docs/IMPLEMENT.md).
 | `accounts active [tool]` | Print active profile name (scripting). |
 | `accounts applied [tool]` | Print applied profile name (scripting). |
 | `accounts env [name] --tool <tool>` | Print one or more `export ...` lines for the profile. |
-| `accounts launch\|run <name> --tool <tool>` | Launch tool with profile env. |
+| `accounts launch <name> --tool <tool>` | Launch tool once with profile env. |
+| `accounts run <tool> [args...]` | Run a tool under the supervisor so MCP/CLI can switch and restart it. |
+| `accounts supervisor status [tool]` | Show running supervisors. |
+| `accounts supervisor switch <name> --tool <tool>` | Switch a running supervisor to another profile. |
+| `accounts supervisor stop <tool>` | Stop a running supervisor and its child process. |
 | `accounts shell <name> --tool <tool>` | Subshell with profile env. |
 | `accounts hook install` | Install `claude()` wrapper — see [docs/hook.md](docs/hook.md). |
 | `accounts hook uninstall` | Remove hook script. |
@@ -125,16 +136,29 @@ Add it to Claude/Codex/opencode/Cursor MCP config as a command server named
 - `current_profile`
 - `switch_profile`
 
-`switch_profile` applies Claude live auth when the target profile is Claude and
-returns a restart handoff command. MCP servers cannot safely kill their parent
-agent process, so the tool returns an instruction such as: exit this session and
-run `CLAUDE_CONFIG_DIR=... claude --continue`.
+For automatic agent restarts, start the agent through `accounts run`:
+
+```bash
+accounts use account001 --tool claude
+accounts run claude --resume
+```
+
+When `switch_profile` is called from that Claude session, `accounts-mcp` contacts
+the supervisor. The supervisor applies/switches the profile, closes the current
+Claude process, and restarts it with the selected profile. Claude uses
+`claude --continue`; Codex uses `codex resume --last`; opencode uses
+`opencode --continue`; custom tools can define `resumeArgs`.
+
+If the agent was not started through `accounts run`, MCP falls back to the safe
+handoff behavior and returns a command such as:
+`CLAUDE_CONFIG_DIR=... claude --continue`.
 
 Human equivalent:
 
 ```bash
 accounts switch account001 --tool claude --resume
 accounts switch account001 --tool claude --resume --launch
+accounts switch account001 --tool claude --supervisor
 accounts switch codex-work --tool codex --resume
 accounts switch ops --tool opencode --resume
 ```
@@ -156,6 +180,9 @@ then invokes the real `claude` binary. Full behavior and footguns: [docs/hook.md
 ~/.hasna/accounts/
   accounts.json              # registry: profiles, current, applied (mode 600)
   claude-hook.sh             # optional shell wrapper
+  supervisors/
+    claude.sock              # local control socket for `accounts run claude`
+    claude.json              # supervisor pid/profile/command metadata
   profiles/
     claude/<name>/           # managed config dir
     claude/<name>/.accounts-auth/   # auth snapshots for apply mode
@@ -171,9 +198,13 @@ Overrides: `ACCOUNTS_HOME`, `ACCOUNTS_STORE_PATH`.
 | Tool | id | Env var | Default dir |
 |------|----|---------|-------------|
 | Claude Code | `claude` | `CLAUDE_CONFIG_DIR` | `~/.claude` |
+| Takumi | `takumi` | `TAKUMI_CONFIG_DIR` | `~/.takumi` |
 | Codex CLI | `codex` | `CODEX_HOME` | `~/.codex` |
+| Gemini CLI | `gemini` | `GEMINI_CONFIG_DIR` | `~/.gemini` |
 | opencode | `opencode` | `OPENCODE_CONFIG_DIR`, `XDG_CONFIG_HOME`, `XDG_DATA_HOME` | `~/.config/opencode` |
 | Cursor Agent | `cursor` | `CURSOR_CONFIG_DIR` | `~/.cursor` |
+| Pi Coding Agent | `pi` | `PI_CODING_AGENT_HOME` | `~/.pi` |
+| Hermes | `hermes` | `HERMES_HOME` | `~/.hermes` |
 | Kimi Code | `kimi` | `KIMI_CODE_HOME` | `~/.kimi-code` |
 | Grok Build | `grok` | `HOME` (process-scoped) | `~/.grok` |
 
@@ -181,6 +212,8 @@ Overrides: `ACCOUNTS_HOME`, `ACCOUNTS_STORE_PATH`.
 For Grok Build, prefer `accounts launch` or `accounts shell`; exporting `HOME`
 globally is intentionally not recommended.
 
+Custom tools can join supervised resume switching with `accounts tools add ... --resume-arg <arg>`.
+
 ## Library
 
 ```ts