Skillget

taskpods

workflow
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a lightweight command-line utility designed to create isolated Git worktrees (referred to as "pods"). It allows developers to run parallel AI tasks in separate branches, keeping their main repository clean, and then easily merge, push, or discard the changes.

Security Assessment
Overall Risk: Low
The tool functions primarily by executing local shell commands to manage Git branches, worktrees, and your preferred code editor. The automated code scan of 12 files found no dangerous patterns, hardcoded secrets, or requests for overly broad permissions. Because it integrates with the `gh` CLI to open pull requests upon task completion, it does interact with your GitHub remote. However, this is standard expected behavior for a Git workflow manager.

Quality Assessment
The project shows strong foundational health. It is licensed under the permissive and standard MIT license. Development appears highly active, with the most recent repository push occurring today. The codebase follows good practices, utilizing CI testing, code coverage tracking, and the "black" code formatting standard. The only notable weakness is its low community visibility—currently sitting at only 5 GitHub stars—which means it has not been widely battle-tested by a large user base.

Verdict
Safe to use, though it should be treated as a young, low-visibility project.
SUMMARY

Parallel AI task pods via Git worktrees.

README.md

taskpods: Parallel AI Task Pods via Git Worktrees

CI
Codecov
PyPI
Python
License
Code style: black
GitHub Sponsors
ko-fi

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:

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.

Reviews (0)

No results found