code-workspace

Git worktree-based workspace management for Claude Code. Inspired by Conductor.

Install

Add to your PATH:

export PATH="$HOME/Developer/code-workspace:$PATH"

Or symlink into ~/.local/bin/:

ln -sf ~/Developer/code-workspace/new-workspace ~/.local/bin/new-workspace
ln -sf ~/Developer/code-workspace/rm-workspace ~/.local/bin/rm-workspace

Usage

Create a workspace

new-workspace <repo-path> [branch-name]

This will:

Create a git worktree under ~/workspaces/<repo-name>/<random-city>/
Check out a new branch (auto-generated or specified)
Install dependencies if package.json exists
Launch Claude Code with workspace context injected

# Auto-generated branch name (e.g. forrest-chang/osaka)
new-workspace ~/Developer/multica-ai/super-multica

# Explicit branch name
new-workspace ~/Developer/multica-ai/super-multica feat/new-feature

# Use current directory
new-workspace .

# Custom workspace location
WORKSPACES_BASE=~/my-workspaces new-workspace ~/Developer/my-repo

Remove a workspace

rm-workspace <workspace-path>

Interactively removes the worktree and optionally deletes the branch.

rm-workspace ~/workspaces/super-multica/osaka

Configuration

Variable	Default	Description
`WORKSPACES_BASE`	`~/workspaces`	Root directory for all workspaces

forrestchang/code-workspace

README