claudework

claudework

A CLI tool for managing Git worktrees with seamless Claude integration. Create isolated development environments and launch Claude directly in your worktree.

Installation

npm install -g claudework

Usage

After installation, use the claudework command:

claudework <command> [options]

Commands

claudework create <branch-name>

Create a new worktree and optionally launch Claude.

Options:

• -d, --directory <dir> - Custom directory name for worktree
• -b, --base <branch> - Base branch to create from (default: main)
• --no-claude - Skip launching Claude after creation

Example:

claudework create feature/new-ui -b develop

claudework remove <branch-name>

Remove a worktree and its associated branch.

Options:

• -f, --force - Force removal even if there are uncommitted changes

Example:

claudework remove feature/old-feature --force

claudework merge <branch-name>

Merge worktree changes to main and clean up.

Options:

• -t, --target <branch> - Target branch to merge into (default: main)
• --no-delete - Keep worktree and branch after merge

Example:

claudework merge feature/completed -t develop

claudework list

List all active worktrees.

Options:

• -v, --verbose - Show detailed information

Example:

claudework list --verbose

claudework status [branch-name]

Show status of a worktree (current if not specified).

Example:

claudework status feature/in-progress

claudework switch <branch-name>

Switch to a different worktree directory.

Options:

• -c, --create - Create the worktree if it doesn't exist

Example:

claudework switch feature/other-work --create

Shell Integration

For the switch command to change your current directory, add this function to your shell profile:

claudework-switch() {
  local path=$(claudework switch "$@" | grep "^cd " | cut -d' ' -f2-)
  if [ -n "$path" ]; then
    cd "$path"
  fi
}

Then use claudework-switch instead of claudework switch.

Requirements

• Git
• Node.js >= 16.0.0
• Claude CLI (for Claude integration features)

License

MIT