kosho

Kosho is a CLI tool that automates git worktree management, enabling developers to work on multiple branches concurrently. It simplifies complex workflows by creating and managing worktrees in dedicated directories, reducing context switching and improving productivity. Ideal for teams using Git for version control.

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.