gh-ws

🔹Report Bug     🔹Request Feature

VSCode workspace management and Claude Code integration extension for GitHub CLI.

Installation

gh extension install HikaruEgashira/gh-ws

Usage

$ gh ws --help
Usage:
  gh ws init          ... Generate workspace from git worktrees
  gh ws init <name>   ... Generate workspace with custom name
  gh ws init --multi  ... Generate workspace from multiple repositories
  gh ws init <name> --multi ... Generate multi-repository workspace with custom name
  gh ws list          ... List existing workspaces
  gh ws edit          ... Edit workspace file in EDITOR
  gh ws remove        ... Remove workspace (interactive selection)
  gh ws sync          ... Sync workspace with current git worktree state
  gh ws add           ... Add current directory to selected workspace
  gh ws claude        ... Run Claude with current workspace folders or select workspace
  gh ws -- <command>  ... Search via fzf and run <command> in the selected workspace directory
  gh ws <command>     ... Search via fzf and run <command> with selected workspace as argument

Examples

# Create workspace file only
gh ws init

# Create workspace with custom name
gh ws init my-workspace

# Create multi-repository workspace
gh ws init --multi

# Create named multi-repository workspace
gh ws init frontend --multi

# List all existing workspaces
gh ws list

# Edit workspace file in your preferred editor
gh ws edit

# Remove workspace
gh ws remove

# Sync workspace with current worktree state
gh ws sync

# Add current directory to selected workspace
gh ws add

# Open workspace in VS Code
gh ws code

# Run Claude Code with workspace folders
gh ws claude

Requirements

• GitHub CLI
• fzf
• VSCode with code command in PATH (for VSCode integration)
• Claude Code (for gh ws claude command)
• Must be used within a git repository (for single-repo workspaces)

How it works

gh ws creates VSCode workspace files in ~/ghq/workspaces/ directory. For single-repository workspaces, it detects git worktrees in the current repository. For multi-repository workspaces, it allows selection of multiple repositories from the entire ~/ghq directory structure and automatically includes their worktrees.

Integration with other gh extensions

Works well with:

• gh-q: Quick repository navigation
• gh-wt: Git worktree management
• Claude Code: AI-powered coding assistant

# Example workflow
gh q                    # Select repository
gh wt add feature/new   # Create new worktree
gh ws init              # Create/update workspace
gh ws claude            # Start Claude Code with all workspace folders

# Quick development workflow
gh q -- gh wt add feature/api    # Create worktree in selected repo
gh q -- gh ws                    # Create workspace and open VSCode
gh q -- gh ws claude             # Start Claude Code with workspace