llmux

Workspace Manager for Claude Code

One machine.
Many workspaces.

Isolated auth, settings, and history per project. Automatic routing based on your directory. Just run claude and it works.

Get started View on GitHub
Terminal
~ $ curl -fsSL https://llmux.sh/install | sh
~ $ llmux init zsh
Shell integration installed. Restart your shell.
~ $ llmux
? Workspaces
  > personal ~/projects
    work ~/work ★
    client ~/client
~/work/api $ claude_
# resolves to "work" workspace automatically

Everything you need

Each workspace is a fully isolated Claude Code environment. Switch projects, not accounts.

→

Automatic routing

Run claude anywhere — no manual env vars or config. llmux resolves the right workspace from your current directory using longest-prefix matching.

🔒

Isolated sessions

Separate auth, history, and settings per workspace. Each gets its own CLAUDE_CONFIG_DIR.

💡

Project-specific insights

Run /insights and get patterns from that workspace's history only. Same Anthropic account, specialized intelligence per project.

🌳

Worktree sessions

Auto-pass --worktree per workspace. List, apply, revert, and resume sessions from the TUI or CLI.

🔑

Separate accounts

Use different subscriptions and API keys per workspace. Personal account for side projects, work account for the day job.

/

Slash commands

Apply or revert worktree changes without leaving Claude Code. /llmux apply brings your session's changes into the main workspace as uncommitted diffs.

⌨

Interactive TUI

Manage workspaces, projects, options, and worktree sessions from a clean terminal UI.

🐚

Shell integration

Supports zsh, bash, and fish. A thin claude() wrapper handles everything behind the scenes.

↑

Auto-update

llmux upgrade checks GitHub releases and upgrades in place. The TUI shows update notices.

Get started in seconds

One command to install, one to set up your shell.

Install
# Install llmux
curl -fsSL https://llmux.sh/install | sh
# Set up shell integration (pick your shell)
llmux init zsh
# Restart your shell, then launch the TUI
llmux

How it works

1

Create workspaces

Each workspace gets its own Claude config directory under ~/.config/llmux/sessions/ with separate auth and settings.

2

Map projects to workspaces

Register directories to workspaces. ~/work/api goes to "work", ~/personal goes to "personal".

3

Just run claude

The shell wrapper calls llmux resolve, finds the right workspace by longest-prefix match, and launches Claude with the correct config.