@hasna/accounts 0.1.5 → 0.1.7

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.
@@ -114,6 +115,7 @@ Implementation details: [docs/IMPLEMENT.md](docs/IMPLEMENT.md).
 | `accounts hook install` | Install `claude()` wrapper — see [docs/hook.md](docs/hook.md). |
 | `accounts hook uninstall` | Remove hook script. |
 | `accounts hook path` | Print hook script path. |
+| `accounts agents` | List Claude agent sessions across **all** profiles (`claude agents` only shows the current account). `--background`, `--profile <name>`, `--json`. |
 | `accounts detect <name>` | Re-detect email from config dir. |
 | `accounts doctor` | Check registry and dirs (exits 1 on errors). |
 
@@ -192,14 +194,37 @@ then invokes the real `claude` binary. Full behavior and footguns: [docs/hook.md
 
 Overrides: `ACCOUNTS_HOME`, `ACCOUNTS_STORE_PATH`.
 
+The native storage API is available from `@hasna/accounts/storage`. It exposes
+the local registry paths, snapshot helpers, and optional S3 registry sync for
+internal cross-machine use:
+
+```ts
+import { getAccountsStorageStatus, storagePush } from "@hasna/accounts/storage";
+
+console.log(getAccountsStorageStatus().local.storePath);
+await storagePush();
+```
+
+Remote sync uses service-owned S3 env names and only syncs the accounts registry
+JSON by default; auth snapshots stay local.
+
+- `HASNA_ACCOUNTS_STORAGE_MODE=local|remote|hybrid`
+- `HASNA_ACCOUNTS_S3_BUCKET=hasna-xyz-opensource-accounts-prod`
+- `HASNA_ACCOUNTS_S3_PREFIX=accounts/`
+- `HASNA_ACCOUNTS_AWS_REGION=us-east-1`
+
 ## Supported tools
 
 | 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` |