kosho

Kosho is a CLI tool that creates and manages git worktrees in dedicated `.kosho/` directories, enabling concurrent work on multiple branches without context switching or repository duplication. It's particularly well-suited for running multiple AI coding agents like Claude Code in separate workspaces, each with independent working state. The tool provides commands to create worktrees, list their status, and prune completed work environments. Kosho supports hooks for custom setup logic and shell completion across bash, zsh, fish, and PowerShell. Teams using Git for version control benefit from reduced context switching, workspace isolation, and more efficient resource usage compared to cloning repositories.

1. **Install kosho**: Run `pip install kosho` or use your package manager (e.g., `brew install kosho`). Ensure Git is installed and configured on your system. 2. **Navigate to your repository**: Use `cd [PROJECT_PATH]` to enter the root directory of your Git repository. 3. **Create a worktree**: Execute `kosho worktree add -b [BRANCH_NAME] [DIRECTORY_PATH]` to create a new worktree for a specific branch. Replace placeholders with your branch name (e.g., `feature/new-ui`) and directory path (e.g., `../worktrees/new-ui`). 4. **List worktrees**: Run `kosho worktree list` to view all active worktrees, their branches, commit statuses, and paths. Use this to track your progress and switch between tasks. 5. **Clean up**: To remove a worktree, use `kosho worktree remove [DIRECTORY_PATH]`. Ensure you’ve committed or stashed changes first to avoid data loss. **Tips:** - Use descriptive directory names (e.g., `../worktrees/feature-auth`) to quickly identify worktrees. - Regularly run `kosho worktree list` to monitor the status of all worktrees and avoid conflicts. - Combine kosho with Git hooks or CI/CD pipelines to automate worktree cleanup after merging branches.