claude-pool 0.1.0 → 0.1.2

package/README.md

@@ -125,6 +125,7 @@ When an account reaches its 5-hour limit, `claude-pool` catches it and migrates
 |---|---|
 | `claude-pool` | Launch Claude session with active account & auto-failover |
 | `claude-pool setup` | Interactive wizard to connect all accounts from scratch |
+| `claude-pool switch [account]` | Manually switch active account with zero session loss |
 | `claude-pool limits` / `remaining` | View exact % session and weekly quota remaining + reset countdowns |
 | `claude-pool dashboard` | Unified pool dashboard with today's consumption & gauges |
 | `claude-pool usage [account]` | Deep token breakdown (Input, Output, Cache Read/Create) per account |
@@ -138,6 +139,16 @@ When an account reaches its 5-hour limit, `claude-pool` catches it and migrates
 
 ---
 
+## ⚡ In-Session Slash Commands
+
+You don't need to exit an active Claude session to check limits or switch accounts! `claude-pool setup` automatically installs custom slash commands into all configured accounts:
+
+- **`/limits`** (or `/pool-limits`): Prints real-time remaining quota percentages and reset timers across all accounts right inside your chat transcript.
+- **`/pool`**: Displays the aggregated token usage dashboard.
+- **`/switch <account>`** (or `/pool-switch <account>`): Transfers your active session transcript and working directory to the target account. Type `/exit` to seamlessly relaunch on the newly switched account with 100% memory preserved!
+
+---
+
 ## 🧠 How It Works Under The Hood
 
 Claude Code stores project sessions as local JSONL transcripts:

package/bin/cli.js

@@ -4,12 +4,14 @@ import { ConfigManager } from '../src/config.js';
 import { MetricsEngine } from '../src/metrics.js';
 import { QuotaEngine } from '../src/quota.js';
 import { ProcessRunner } from '../src/runner.js';
-import { runSetupWizard, checkAuthStatus, runAccountLogin } from '../src/setup.js';
+import { runSetupWizard, checkAuthStatus, runAccountLogin, ensureAllSlashCommands } from '../src/setup.js';
 import { colors, formatTokenCount, makePill, makeGauge, printTable } from '../src/ui.js';
 
 const KNOWN_COMMANDS = new Set([
   'start',
   'setup',
+  'switch',
+  'use',
   'limits',
   'remaining',
   'quota',
@@ -33,6 +35,9 @@ const firstArg = args[0];
 const cfg = new ConfigManager();
 
 async function handleCommand() {
+  const accounts = cfg.loadAccounts();
+  ensureAllSlashCommands(accounts);
+
   if (!firstArg || (!firstArg.startsWith('-') && !KNOWN_COMMANDS.has(firstArg))) {
     // Default: run interactive session with failover
     const runner = new ProcessRunner(cfg);
@@ -52,6 +57,55 @@ async function handleCommand() {
       break;
     }
 
+    case 'switch':
+    case 'use': {
+      let targetName = args[1];
+      const accounts = cfg.loadAccounts();
+
+      if (!targetName) {
+        console.log(`\n${colors.indigo}${colors.bold}Switch Active Claude Account:${colors.reset}\n`);
+        accounts.forEach((a, idx) => {
+          const activeTag = idx === 0 ? `${colors.emerald} [ACTIVE]${colors.reset}` : '';
+          const emailTag = a.email ? ` (${a.email})` : '';
+          console.log(`  ${colors.bold}${idx + 1})${colors.reset} ${a.name}${emailTag}${activeTag}`);
+        });
+        console.log();
+        const { default: readline } = await import('readline/promises');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const choice = await rl.question(`Select account (1-${accounts.length}): `);
+        rl.close();
+        const chosenIdx = parseInt(choice.trim(), 10) - 1;
+        if (chosenIdx >= 0 && chosenIdx < accounts.length) {
+          targetName = accounts[chosenIdx].name;
+        } else {
+          console.log(`${colors.red}Invalid selection.${colors.reset}`);
+          return;
+        }
+      }
+
+      const prevActive = accounts[0];
+      const target = accounts.find(a => a.name.toLowerCase() === targetName.toLowerCase());
+      if (!target) {
+        console.log(`${colors.red}Error: Account '${targetName}' not found in pool.${colors.reset}`);
+        return;
+      }
+
+      target.rateLimitedUntil = null;
+      cfg.updateAccountPriority(target.name, 1);
+
+      if (prevActive && prevActive.name.toLowerCase() !== target.name.toLowerCase()) {
+        const { SessionSyncEngine } = await import('../src/sessionSync.js');
+        const syncedId = SessionSyncEngine.transferSession(prevActive, target);
+        if (syncedId) {
+          console.log(`${colors.emerald}✓ Synchronized active session (${syncedId.slice(0, 12)}...) to ${target.name}.${colors.reset}`);
+        }
+      }
+
+      console.log(`\n${colors.emerald}✓ Active account is now: ${colors.bold}${target.name} (Priority 1)${colors.reset}`);
+      console.log(`${colors.dim}Run ${colors.reset}${colors.indigo}claude-pool${colors.reset}${colors.dim} to start working on ${target.name}.${colors.reset}\n`);
+      break;
+    }
+
     case 'limits':
     case 'remaining':
     case 'quota': {
@@ -312,6 +366,7 @@ ${colors.bold}USAGE:${colors.reset}
 
 ${colors.bold}COMMANDS:${colors.reset}
   ${colors.indigo}claude-pool${colors.reset}                  Launch Claude session with pooled accounts & auto-failover
+  ${colors.indigo}claude-pool switch [acct]${colors.reset}    Manually switch active account (or interactive picker)
   ${colors.indigo}claude-pool setup${colors.reset}            Guided setup wizard to connect accounts from scratch
   ${colors.indigo}claude-pool limits${colors.reset}           Inspect remaining session/weekly % quota & reset timers
   ${colors.indigo}claude-pool dashboard${colors.reset}        Real-time aggregated token metrics & model stats

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pool",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Multi-account token pooling and seamless failover manager for Claude Code CLI",
   "main": "bin/cli.js",
   "type": "module",

package/src/runner.js

@@ -4,6 +4,7 @@ import os from 'os';
 import { SessionSyncEngine } from './sessionSync.js';
 import { MetricsEngine } from './metrics.js';
 import { QuotaEngine } from './quota.js';
+import { ensureAllSlashCommands } from './setup.js';
 import { renderSessionHeader, renderFailoverBanner, colors } from './ui.js';
 
 export class ProcessRunner {
@@ -59,6 +60,9 @@ export class ProcessRunner {
       return;
     }
 
+    // Automatically ensure /limits, /pool, /switch are installed across all accounts and project
+    ensureAllSlashCommands(accounts);
+
     let resumeSessionId = null;
     for (let i = 0; i < extraArgs.length; i++) {
       if ((extraArgs[i] === '-r' || extraArgs[i] === '--resume') && i + 1 < extraArgs.length) {
@@ -95,6 +99,18 @@ export class ProcessRunner {
         break;
       }
 
+      // Check if user manually switched account during the session (e.g. via /pool-switch)
+      const refreshedAccounts = this.configManager.loadAccounts();
+      const readyRefreshed = this.getReadyAccounts(refreshedAccounts);
+      if (readyRefreshed.length > 0 && readyRefreshed[0].name.toLowerCase() !== activeAccount.name.toLowerCase()) {
+        const newActive = readyRefreshed[0];
+        console.log(`\n${colors.emerald}✓ Account switch detected! Continuing session on ${newActive.name}...${colors.reset}\n`);
+        const latestId = SessionSyncEngine.getLatestSessionId(newActive);
+        if (latestId) resumeSessionId = latestId;
+        activeAccount = newActive;
+        continue;
+      }
+
       if (exitCode === 0) {
         console.log(`\n${colors.emerald}✓ Claude session finished normally.${colors.reset}`);
         break;

package/src/setup.js

@@ -57,6 +57,46 @@ export function checkAuthStatus(configDir) {
   return { ok: false, email: null, plan: null };
 }
 
+export function installSlashCommands(configDir) {
+  const cmdDir = path.join(configDir, 'commands');
+  try {
+    fs.mkdirSync(cmdDir, { recursive: true });
+    // /pool
+    fs.writeFileSync(
+      path.join(cmdDir, 'pool.md'),
+      '---\ndescription: View Claude Pool token dashboard and status\n---\nRun `npx -y claude-pool dashboard` (or `claude-pool dashboard`) using the command-line/Bash tool and display the exact formatted output.\n',
+      'utf8'
+    );
+    // /limits
+    fs.writeFileSync(
+      path.join(cmdDir, 'limits.md'),
+      '---\ndescription: View remaining session and weekly quotas across all accounts in the pool\n---\nRun `npx -y claude-pool limits` (or `claude-pool limits`) using the command-line/Bash tool and display the exact formatted output table.\n',
+      'utf8'
+    );
+    // /switch
+    fs.writeFileSync(
+      path.join(cmdDir, 'switch.md'),
+      '---\ndescription: Switch active Claude account in the pool\n---\nRun `npx -y claude-pool switch $ARGUMENTS` (or `claude-pool switch $ARGUMENTS`) using the command-line/Bash tool and display the result.\nIf switched successfully, inform the user that their session was synchronized and they can run `/exit` to restart immediately on the new account.\n',
+      'utf8'
+    );
+    // Also include /pool-limits and /pool-switch aliases
+    fs.copyFileSync(path.join(cmdDir, 'limits.md'), path.join(cmdDir, 'pool-limits.md'));
+    fs.copyFileSync(path.join(cmdDir, 'switch.md'), path.join(cmdDir, 'pool-switch.md'));
+  } catch {}
+}
+
+export function ensureAllSlashCommands(accounts = []) {
+  try {
+    installSlashCommands(path.join(os.homedir(), '.claude'));
+    for (const a of accounts) {
+      if (a && a.configDir) installSlashCommands(a.configDir);
+    }
+    // Also install to current working directory .claude if it exists or in project
+    const localClaudeDir = path.join(process.cwd(), '.claude');
+    installSlashCommands(localClaudeDir);
+  } catch {}
+}
+
 export async function runSetupWizard() {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
@@ -159,6 +199,9 @@ export async function runSetupWizard() {
   rl.close();
 
   if (accounts.length > 0) {
+    for (const a of accounts) {
+      installSlashCommands(a.configDir);
+    }
     cfg.saveAccounts(accounts);
     console.log(`\n${colors.emerald}✓ Setup complete! Your Claude Pool is configured:${colors.reset}\n`);