{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "r1c7-cluxmate--run-parallel-tasks-in-separate-worktrees",
 "repo": "r1c7/CluxMate",
 "repo_url": "https://github.com/r1c7/CluxMate",
 "repo_slug": "r1c7-cluxmate",
 "title": "Run parallel agent tasks in separate git worktrees",
 "page_title": "How to run parallel agent tasks in separate git worktrees with Clux Mate",
 "summary": "Give each task its own linked worktree and branch so sessions stop editing the same files.",
 "who": "A developer who has two or more tasks in the same repository and wants agent sessions to run at the same time without conflicts.",
 "problem": "When several agent sessions edit the same working directory, their changes collide and are hard to separate.",
 "outcome": "Each session works in its own linked git worktree on its own branch, and deleting a session can remove its tree.",
 "steps": [
  "Open the project in the Textual TUI by running `cluxmate` from the repository root.",
  "Create a session worktree from the desktop sidebar, or run `cluxmate worktree …` with the arguments for your branch.",
  "Give each worktree its own task, since inside a tree the composer does not offer branch switches.",
  "When a task ends, delete its session and choose whether the worktree goes with it."
 ],
 "agent_prompt": "Use the CluxMate repo (r1c7/CluxMate) to create a separate worktree for the task <task name> with cluxmate worktree. Expected output: a new linked git worktree on its own branch. Verify with git worktree list that the new tree exists and that the main working directory is unchanged.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Worktrees depend on git, so the project must already be a git repository, and the README excerpt does not list the full argument set for cluxmate worktree.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "A CluxMate install (install steps are not in the README excerpt provided, so follow the README's install section)",
  "An OpenAI-compatible API endpoint, its base_url, and an API key",
  "A git repository for the project you want the agent to work on"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/r1c7-cluxmate/run-parallel-tasks-in-separate-worktrees/",
 "md": "https://dedupedai.com/use-cases/r1c7-cluxmate/run-parallel-tasks-in-separate-worktrees/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/r1c7-cluxmate--run-parallel-tasks-in-separate-worktrees.json",
 "api_version": "v1"
}
