taskpods: Parallel AI Task Pods via Git Worktrees

---

taskpods is a lightweight CLI that lets you spin up disposable AI pods inside your Git repo.
Each pod is an isolated Git worktree/branch — perfect for experimenting with Copilot, Cursor, or Claude Code without polluting main.
When done, you can merge, PR, or nuke the pod entirely.

---

✨ Features

• Instant sandbox: taskpods start <name> → creates .taskpods/<name> and pods/<name> from main.
• Clean exit: taskpods done <name> → commit, push, open a PR (via [gh CLI]), then remove the worktree.
• Abort button: taskpods abort <name> → deletes an unpushed pod safely.
• Status overview: taskpods list → see all active pods and paths.
• Housekeeping: taskpods prune → removes pods already merged upstream.

---

🚀 Installation

Quick Install

pip install taskpods

Alternatives

From GitHub (latest dev):

pip install git+https://github.com/yanairon/taskpods.git

Manual:

curl -O https://raw.githubusercontent.com/yanairon/taskpods/main/taskpods.py
chmod +x taskpods.py
sudo mv taskpods.py /usr/local/bin/taskpods

Requirements:

• Python 3.9+
• Git 2.5+ with worktree support
• A Git repo with a remote named origin

---

📖 Usage

Start a new pod

taskpods start fix-typos

Finish & PR

taskpods done fix-typos -m "Fix docs typos" --remove

Abort

taskpods abort fix-typos

List pods

taskpods list

Prune merged

taskpods prune

---

⚙️ Editor Configuration

• Env var:

export TASKPODS_EDITOR="vim"
export TASKPODS_EDITOR="code"
export TASKPODS_EDITOR="cursor"

• Config file ~/.taskpodsrc:

{
  "editor": "vim",
  "default_base": "main"
}

• CLI flag:

taskpods start my-feature --editor vim

Supported editors: Cursor, VS Code, Sublime, Atom, Vim/Neovim, Emacs, or any in your PATH.

---

❤️ Support

If taskpods saves you time, please consider supporting:

• GitHub Sponsors
• 

Your support helps keep the project maintained and evolving for the community!

---

📜 License

MIT – see LICENSE.

---

🤔 Why worktrees?

Git worktrees let you check out multiple branches in separate dirs without cloning. They’re fast, disk-light, and easy to clean up.
taskpods wraps the common git worktree operations with sensible defaults and quality-of-life features like PR creation and safe aborts.

---

👩‍💻 Development

git clone https://github.com/yanairon/taskpods.git
cd taskpods
pip install -e ".[dev]"
pre-commit install

Run tests:

make test
make test-cov
make check

Tools used: Black, Flake8, MyPy, Pre-commit.

---

🤝 Contributing

Contributions, bug reports, and feature requests are welcome!
Open an issue or submit a PR.