@hasna/accounts 0.1.3 → 0.1.4

package/README.md

@@ -91,6 +91,7 @@ Implementation details: [docs/IMPLEMENT.md](docs/IMPLEMENT.md).
 | `accounts login <name> --tool <tool>` | Launch the tool's login flow in an isolated profile dir. |
 | `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 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. |
@@ -108,6 +109,36 @@ Implementation details: [docs/IMPLEMENT.md](docs/IMPLEMENT.md).
 
 See `accounts --help` for `set`, `rename`, `remove`, `tools`, etc.
 
+## Agent / MCP Switching
+
+`accounts` ships a stdio MCP server:
+
+```bash
+accounts-mcp
+```
+
+Add it to Claude/Codex/opencode/Cursor MCP config as a command server named
+`accounts`. It exposes:
+
+- `list_tools`
+- `list_profiles`
+- `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`.
+
+Human equivalent:
+
+```bash
+accounts switch account001 --tool claude --resume
+accounts switch account001 --tool claude --resume --launch
+accounts switch codex-work --tool codex --resume
+accounts switch ops --tool opencode --resume
+```
+
 ## Shell hook (optional)
 
 ```bash

package/dist/cli.js

@@ -6577,6 +6577,7 @@ var toolDefSchema = exports_external.object({
   bin: exports_external.string().min(1),
   loginArgs: exports_external.array(exports_external.string()).optional(),
   loginHint: exports_external.string().optional(),
+  resumeArgs: exports_external.array(exports_external.string()).optional(),
   accountFile: exports_external.string().optional(),
   emailPath: exports_external.array(exports_external.string()).optional()
 });
@@ -6745,6 +6746,7 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".claude"),
     bin: "claude",
     loginHint: "run /login inside Claude, then /exit when done",
+    resumeArgs: ["--continue"],
     accountFile: ".claude.json",
     emailPath: ["oauthAccount", "emailAddress"]
   },
@@ -6755,7 +6757,8 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".codex"),
     bin: "codex",
     loginArgs: ["login"],
-    loginHint: "complete the Codex login flow for this CODEX_HOME"
+    loginHint: "complete the Codex login flow for this CODEX_HOME",
+    resumeArgs: ["resume", "--last"]
   },
   {
     id: "opencode",
@@ -6768,7 +6771,8 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".config", "opencode"),
     bin: "opencode",
     loginArgs: ["auth", "login"],
-    loginHint: "complete opencode auth login for this isolated config/data root"
+    loginHint: "complete opencode auth login for this isolated config/data root",
+    resumeArgs: ["--continue"]
   },
   {
     id: "cursor",
@@ -7575,6 +7579,50 @@ function finalizeLogin(name, toolId) {
   return { profile: updated, applied: false };
 }
 
+// src/lib/switch.ts
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:=@+-]+$/.test(value))
+    return value;
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function commandLine(env2, command) {
+  return `${formatEnvAssignments(env2)} ${command.map(shellQuote).join(" ")}`.trim();
+}
+function commandFor(tool, opts) {
+  return [tool.bin, ...opts.resume ? tool.resumeArgs ?? [] : [], ...opts.args ?? []];
+}
+function switchProfile(name, opts = {}) {
+  const profile = getProfile(name, opts.tool);
+  const tool = getTool(profile.tool);
+  const mode = opts.mode ?? "auto";
+  if (!["auto", "apply", "env", "active"].includes(mode)) {
+    throw new AccountsError(`invalid switch mode "${mode}"`);
+  }
+  const env2 = profileEnv(profile, tool);
+  let applied = false;
+  if (mode === "apply" || mode === "auto" && tool.id === "claude") {
+    applyProfile(name, tool.id);
+    applied = true;
+  } else {
+    useProfile(name, tool.id);
+  }
+  const command = commandFor(tool, opts);
+  const restartRequired = opts.resume === true || applied || mode === "env";
+  const message = applied ? `${profile.name} is now the live/default ${tool.label} profile` : `${profile.name} is now the active ${tool.label} profile`;
+  return {
+    profile: getProfile(name, tool.id),
+    tool,
+    applied,
+    active: true,
+    env: env2,
+    exports: formatExportLines(env2),
+    command,
+    commandLine: commandLine(env2, command),
+    restartRequired,
+    message
+  };
+}
+
 // src/cli.ts
 var program2 = new Command;
 function die(message) {
@@ -7730,6 +7778,30 @@ program2.command("applied").argument("[tool]", "tool id (default: claude)").desc
     die(`no applied profile for "${tool}". Run \`accounts apply <name>\` first.`);
   console.log(p.name);
 }));
+program2.command("switch").argument("<name>", "profile name").argument("[args...]", "extra args passed when printing/launching the tool").description("switch to a profile and print a restart/resume command; use --launch to run it").option("-t, --tool <tool>", "tool when the profile name exists for multiple tools").option("--mode <mode>", "switch mode: auto, apply, env, active", "auto").option("--resume", "include the tool's resume/continue args in the handoff command").option("--launch", "launch the tool after switching").option("--json", "output JSON").action(action((name, args, opts) => {
+  const result = switchProfile(name, { tool: opts.tool, mode: opts.mode, resume: opts.resume, args });
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(source_default.green(`✓ ${result.message}`));
+    if (result.applied)
+      console.log(source_default.dim("  live/default auth updated"));
+    console.log(source_default.dim(`  restart command: ${result.commandLine}`));
+    if (!opts.launch) {
+      console.log(source_default.yellow("  Exit the current agent session, then run the restart command above."));
+    }
+  }
+  if (opts.launch) {
+    const [bin, ...launchArgs] = result.command;
+    const res = spawnSync(bin, launchArgs, {
+      stdio: "inherit",
+      env: { ...process.env, ...result.env }
+    });
+    if (res.error)
+      die(`failed to launch ${bin}: ${res.error.message}`);
+    process.exit(res.status ?? 0);
+  }
+}));
 var hook = program2.command("hook").description("install a shell wrapper for claude");
 hook.command("install").description(`write ${join10(accountsHome(), "claude-hook.sh")}`).action(action(() => {
   const { path, created } = installHook();

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { importProfile, ensureProfileForLogin } from "./lib/import-profile.js";
 export type { ImportOptions } from "./lib/import-profile.js";
 export { finalizeLogin } from "./lib/login.js";
 export type { FinalizeLoginResult } from "./lib/login.js";
+export { switchProfile } from "./lib/switch.js";
+export type { SwitchMode, SwitchOptions, SwitchResult } from "./lib/switch.js";
 export { pickProfile } from "./lib/pick.js";
 export type { PickOptions, PickResult } from "./lib/pick.js";
 export { installHook, uninstallHook, hookPath, hookScript, shellSnippet } from "./lib/hook.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,YAAY,EACZ,OAAO,EACP,SAAS,EACT,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/F,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,YAAY,EACZ,OAAO,EACP,SAAS,EACT,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/F,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -3998,6 +3998,7 @@ var toolDefSchema = exports_external.object({
   bin: exports_external.string().min(1),
   loginArgs: exports_external.array(exports_external.string()).optional(),
   loginHint: exports_external.string().optional(),
+  resumeArgs: exports_external.array(exports_external.string()).optional(),
   accountFile: exports_external.string().optional(),
   emailPath: exports_external.array(exports_external.string()).optional()
 });
@@ -4162,6 +4163,7 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".claude"),
     bin: "claude",
     loginHint: "run /login inside Claude, then /exit when done",
+    resumeArgs: ["--continue"],
     accountFile: ".claude.json",
     emailPath: ["oauthAccount", "emailAddress"]
   },
@@ -4172,7 +4174,8 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".codex"),
     bin: "codex",
     loginArgs: ["login"],
-    loginHint: "complete the Codex login flow for this CODEX_HOME"
+    loginHint: "complete the Codex login flow for this CODEX_HOME",
+    resumeArgs: ["resume", "--last"]
   },
   {
     id: "opencode",
@@ -4185,7 +4188,8 @@ var BUILTIN_TOOLS = [
     defaultDir: join2(homedir2(), ".config", "opencode"),
     bin: "opencode",
     loginArgs: ["auth", "login"],
-    loginHint: "complete opencode auth login for this isolated config/data root"
+    loginHint: "complete opencode auth login for this isolated config/data root",
+    resumeArgs: ["--continue"]
   },
   {
     id: "cursor",
@@ -4891,6 +4895,49 @@ function finalizeLogin(name, toolId) {
   useProfile(name, tool.id);
   return { profile: updated, applied: false };
 }
+// src/lib/switch.ts
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:=@+-]+$/.test(value))
+    return value;
+  return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function commandLine(env, command) {
+  return `${formatEnvAssignments(env)} ${command.map(shellQuote).join(" ")}`.trim();
+}
+function commandFor(tool, opts) {
+  return [tool.bin, ...opts.resume ? tool.resumeArgs ?? [] : [], ...opts.args ?? []];
+}
+function switchProfile(name, opts = {}) {
+  const profile = getProfile(name, opts.tool);
+  const tool = getTool(profile.tool);
+  const mode = opts.mode ?? "auto";
+  if (!["auto", "apply", "env", "active"].includes(mode)) {
+    throw new AccountsError(`invalid switch mode "${mode}"`);
+  }
+  const env = profileEnv(profile, tool);
+  let applied = false;
+  if (mode === "apply" || mode === "auto" && tool.id === "claude") {
+    applyProfile(name, tool.id);
+    applied = true;
+  } else {
+    useProfile(name, tool.id);
+  }
+  const command = commandFor(tool, opts);
+  const restartRequired = opts.resume === true || applied || mode === "env";
+  const message = applied ? `${profile.name} is now the live/default ${tool.label} profile` : `${profile.name} is now the active ${tool.label} profile`;
+  return {
+    profile: getProfile(name, tool.id),
+    tool,
+    applied,
+    active: true,
+    env,
+    exports: formatExportLines(env),
+    command,
+    commandLine: commandLine(env, command),
+    restartRequired,
+    message
+  };
+}
 // src/lib/pick.ts
 import * as readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
@@ -4990,6 +5037,7 @@ export {
   updateProfile,
   uninstallHook,
   toolDefSchema,
+  switchProfile,
   storeSchema,
   storePath,
   snapshotLiveAuthToProfile,

package/dist/lib/switch.d.ts

@@ -0,0 +1,22 @@
+import type { Profile, ToolDef } from "../types.js";
+export type SwitchMode = "auto" | "apply" | "env" | "active";
+export interface SwitchOptions {
+    tool?: string;
+    mode?: SwitchMode;
+    resume?: boolean;
+    args?: string[];
+}
+export interface SwitchResult {
+    profile: Profile;
+    tool: ToolDef;
+    applied: boolean;
+    active: boolean;
+    env: Record<string, string>;
+    exports: string;
+    command: string[];
+    commandLine: string;
+    restartRequired: boolean;
+    message: string;
+}
+export declare function switchProfile(name: string, opts?: SwitchOptions): SwitchResult;
+//# sourceMappingURL=switch.d.ts.map

package/dist/lib/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/lib/switch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAOpD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,YAAY,CAmClF"}

package/dist/lib/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/lib/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAgC,MAAM,aAAa,CAAC;AAGzE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,EA4DlC,CAAC;AAEF,eAAO,MAAM,YAAY,WAAW,CAAC;AAIrC,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,oFAAoF;AACpF,wBAAgB,SAAS,IAAI,OAAO,EAAE,CAMrC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAS3C;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAanD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAWjD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/lib/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAgC,MAAM,aAAa,CAAC;AAGzE;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,EA+DlC,CAAC;AAEF,eAAO,MAAM,YAAY,WAAW,CAAC;AAIrC,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,oFAAoF;AACpF,wBAAgB,SAAS,IAAI,OAAO,EAAE,CAMrC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAS3C;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAanD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAWjD"}

package/dist/mcp.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":""}