Polydev

Polydev

Polydev is an agent orchestration toolkit for running parallel development work with Git worktrees and terminal-hosted coding agents. It helps split a larger task into independent branches, launch agents in isolated terminals, monitor their status, and clean up the resulting worktrees when the work is complete.

Design Point Of View

Polydev is Windows-first. Linux/macOS support is included, but this project intentionally gives Windows and WezTerm first-class attention because most parallel agent tooling is built around Unix-like environments.

Polydev is semi-automated, not a sealed autopilot. It automates the repetitive parts of orchestration while keeping terminal sessions visible, inspectable, and interruptible. A human can step in to send commands, handle `hil` decisions, recover sessions, or stop work when context changes.

Polydev should not be tied to one coding agent. The same orchestration model should be usable from Codex CLI, Cursor, OpenCode, Claude Code, Gemini CLI, and other agent tools through thin adapters.

What It Provides

• Parallel agent execution across Git worktrees
• Terminal session management for tmux on Linux/macOS and WezTerm on Windows
• task.toon status files for worktree session coordination
• Background command hosting for builds, tests, servers, and one-off agent investigations
• Scheduled agent tasks through Polycron
• Agent workflow instructions and command entry points for planning, execution, and monitoring

Requirements

• Git
• At least one supported coding agent, such as Codex CLI, Cursor, OpenCode, Claude Code, or Gemini CLI
• tmux on Linux/macOS, or WezTerm on Windows
• Bash-compatible shell for Bash scripts
• PowerShell 7 (pwsh) for Windows-native Codex adapter scripts

Repository Layout

polydev/      Installable Polydev skill package; copy this directory to the skill root
  SKILL.md    Top-level skill entry point
  references/ Workflow and architecture references
  scripts/    Stable sc