claude-switchboard 1.0.27

claude-switchboard: multi-account manager for Claude Code CLI profiles

Claude Switchboard

Multi-account manager for Claude Code CLI

---

The Problem

Claude CLI stores everything in ~/.claude/ — one account at a time. Switching means logging out, logging in, and losing your flow.

The Solution

Claude Switchboard gives you:

• Multiple profiles — claude-work, claude-personal, claude-client — each fully isolated
• Direct launch — type claude-work from anywhere, no menu needed
• Shared settings — define MCP servers and instructions once, sync everywhere
• One-click transfer — export/import profiles between machines

---

Quick Start

Step 1: Install

Choose one method:

# npm
npm install -g claude-switchboard

# pip
pip install claude-switchboard

# or one-liner (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/ApoorvDixitt/claude-switchboard/master/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/ApoorvDixitt/claude-switchboard/master/install.ps1 | iex

Step 2: Launch

claude-switchboard

Step 3: Create your first profile

> Select: Create New Account
> Enter name: work
> Profile type: 1 (Separate Workspace)
> Login now? y

Done! Now you can run claude-work from any terminal.

---

How It Works

You type:           What happens:
─────────────────────────────────────────────────────
claude-work    →    CLAUDE_CONFIG_DIR=~/.claude-work
                    claude starts with isolated config

claude-personal →   CLAUDE_CONFIG_DIR=~/.claude-personal  
                    completely separate account

Each profile gets:

• Own config directory (~/.claude-<name>/)
• Own credentials and login
• Own conversation history
• Shared MCP servers (optional)

---

Features

Core

Feature	Description
Create Profile	Isolated config directory, own credentials
Direct Launch	claude-work command works from any terminal
Shared Settings	MCP servers + CLAUDE.md sync to all profiles
Export/Import	Transfer profiles between machines via token

Profile Types

Type	Best For	Config Dir	Authentication
Separate Workspace	Different accounts (work/personal)	~/.claude-<name>/	Each has own login
Shared Workspace	Same person, different API providers	~/.claude/	AWS Bedrock, GCP Vertex, or API Key

Shared Workspace profiles share the same ~/.claude/ directory (conversations, memory, history) but use different authentication providers. Claude CLI handles the authentication automatically via environment variables.

Menu Options

1. List Accounts        — see all profiles and status
2. Create New Account   — make a new profile  
3. Launch Account       — start a profile
4. Rename Account       — change profile name
5. Delete Account       — remove profile permanently
6. Shared Settings      — configure MCP servers, CLAUDE.md
7. Plugins & Marketplace — manage plugins
E. Export Profile       — generate transfer token
I. Import Profile       — restore from token

---

Shared Settings

Define once, apply everywhere.

Edit shared MCP servers:

Menu → 6 (Shared Settings) → 1 (Edit MCP + Settings)

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem", "/home/user"]
    }
  }
}

Edit shared instructions:

Menu → 6 (Shared Settings) → 2 (Edit CLAUDE.md)

Always respond concisely.
Use TypeScript for code examples.

These automatically apply to all profiles on launch.

---

Export / Import

Transfer a profile to another machine:

On source machine:

Menu → E → select profile → copy the token

On target machine:

Menu → I → paste token → profile restored

The token includes credentials, settings, and launcher (~5KB).

---

Folder Structure

~/
├── claude-accounts/           # Launcher scripts
│   ├── claude-work.sh
│   ├── claude-personal.sh
│   └── .profile-registry.json
│
├── claude-shared/             # Shared settings (syncs to all)
│   ├── settings.json          # MCP servers, env vars
│   └── CLAUDE.md              # Global instructions
│
├── .claude-work/              # Work profile config
├── .claude-personal/          # Personal profile config
└── .local/bin/                # Symlinks for direct launch
    ├── claude-work
    └── claude-personal

---

Requirements

• Claude CLI installed
• Linux/macOS: Bash 3.2+, curl, jq (auto-installed on first run)
• Windows: PowerShell 5.1+
• Optional: gum for modern TUI (auto-offered)

---

Documentation

• Installation Guide
• Usage Guide

---

License

MIT

---

Built by Apoorv Dixit