{"id":29032311,"url":"https://github.com/jlowin/claude-wt","last_synced_at":"2026-01-20T16:58:01.789Z","repository":{"id":301269783,"uuid":"1008709867","full_name":"jlowin/claude-wt","owner":"jlowin","description":"🌴 Simple utility for managing parallel Claude Code instances ","archived":false,"fork":false,"pushed_at":"2025-07-07T16:41:44.000Z","size":24,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-07T17:02:17.827Z","etag":null,"topics":["agent","claude","claude-ai","claude-code"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jlowin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-26T01:27:01.000Z","updated_at":"2025-07-07T16:41:48.000Z","dependencies_parsed_at":"2025-06-26T02:46:35.129Z","dependency_job_id":null,"html_url":"https://github.com/jlowin/claude-wt","commit_stats":null,"previous_names":["jlowin/claude-wt"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jlowin/claude-wt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlowin%2Fclaude-wt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlowin%2Fclaude-wt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlowin%2Fclaude-wt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlowin%2Fclaude-wt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jlowin","download_url":"https://codeload.github.com/jlowin/claude-wt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlowin%2Fclaude-wt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267945354,"owners_count":24170218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","claude","claude-ai","claude-code"],"created_at":"2025-06-26T10:36:20.106Z","updated_at":"2026-01-20T16:58:01.747Z","avatar_url":"https://github.com/jlowin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌴 Claude-Worktree\n\nRun multiple Claude Code instances in parallel without stepping on each other. This CLI creates isolated git worktrees for each Claude session, so you can work on different features simultaneously while keeping your main branch clean.\n\n*Inspired by a script from [aaazzam](https://github.com/aaazzam).*\n\n## 🚀 Quick Start\n\nJump right in without installing anything:\n\n```bash\nuvx claude-wt new \"implement user authentication\"\n```\n\n**That's it.** You're now working in a clean branch where Claude can't mess up your pristine codebase.\n\n### Installation Options\n\nIf you prefer global installation:\n\n```bash\nuv tool install claude-wt\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/anthropics/claude-wt.git\ncd claude-wt\nuv install -e .\n```\n\n## 🎯 Commands\n\n### ✨ Start Fresh: `new`\n\nSpin up a new isolated Claude session:\n\n```bash\nuvx claude-wt new \"implement user authentication\"\n```\n\nBehind the scenes: creates a timestamp branch, sets up a worktree in `.claude-wt/worktrees/`, and launches Claude with your query.\n\nWant a memorable branch name? Use `--name`:\n\n```bash\nuvx claude-wt new \"fix the parser\" --name parser-fix\n```\n\nNeed to branch from a specific source? Use `--branch`:\n\n```bash\nuvx claude-wt new \"hotfix for prod\" --branch main --name hotfix-123\n```\n\n### 🔄 Pick Up Where You Left Off: `resume`\n\nClaude sessions are like good TV shows—you want to continue watching:\n\n```bash\nuvx claude-wt resume 20241201-143022\n```\n\nThe session ID is shown when you create it.\n\n### 📋 See What's Running: `list`\n\nSee all your active worktrees:\n\n```bash\nuvx claude-wt list\n```\n\nShows each session with its health status.\n\n### 🧹 Clean Up: `clean`\n\nRemove a specific session when you're done:\n\n```bash\nuvx claude-wt clean 20241201-143022\n```\n\nOr clean everything:\n\n```bash\nuvx claude-wt clean --all  # The Marie Kondo approach\n```\n\n## 🔧 How It Works\n\nThink of it like having multiple parallel universes for your code:\n\n1. **Branch Creation** → Each session gets its own branch (`claude-wt-{timestamp}` or your custom name)\n2. **Worktree Setup** → Creates a separate directory in `.claude-wt/worktrees/` so files don't conflict\n3. **Claude Launch** → Starts Claude in the isolated environment with full repo access\n4. **Session Management** → Resume, list, and clean up sessions effortlessly\n\n## 🎁 Why You'll Love This\n\n- **Fear-Free Experimentation** → Claude can't break your main branch even if it tries\n- **Mental Clarity** → No more \"did I commit that test code?\" anxiety\n- **Context Switching** → Jump between different Claude conversations effortlessly\n- **Easy Cleanup** → One command to remove all experimental branches\n- **Clean History** → Your main branch stays pristine for serious work\n\n## 📋 What You Need\n\n- **Python 3.12+**\n- **Git with worktree support** (any recent version)\n- **Claude CLI** (installed and authenticated)\n\n## 🛠️ Development\n\nUses uv for dependency management:\n\n```bash\nuv sync\nuv run claude-wt --help\n```\n\nOr test changes without installing:\n\n```bash\nuvx --from . claude-wt --help\n```\n\n---\n\n*Built with the assumption that your Claude sessions shouldn't be a game of git-roulette with your main branch.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlowin%2Fclaude-wt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjlowin%2Fclaude-wt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlowin%2Fclaude-wt/lists"}