poly-weaver
v0.13.3
Published
Orchestrates pluggable AI coding agents in an iterative plan-review loop
Readme
poly-weaver
A minimal agent workflow for shipping day-to-day features.
Watch the poly-weaver demo video

Installation
Prerequisites
- Node.js 22.17 or newer, with the 23.x line excluded (22.17+, 24.x, 25.x, and 26.x+ are supported; only 23.x is not). On Windows, this Node floor is required for libuv raw VT input so ConPTY can deliver mouse wheel, Shift+Tab, kitty keyboard protocol, and bracketed-paste delimiters as VT bytes. Older Node versions still handle ordinary typing and basic control/navigation keys, but those richer terminal inputs degrade.
- A C++ toolchain for node-pty:
- Windows - plus Windows Terminal 1.22+ if you run poly-weaver inside Windows Terminal (older builds crash the hosting tab - see
docs/windows-terminal.md) - macOS
- Linux
- Windows - plus Windows Terminal 1.22+ if you run poly-weaver inside Windows Terminal (older builds crash the hosting tab - see
- At least one supported agent CLI installed and authenticated:
npm install -g poly-weaverUsage
poly-weaverThis opens an interactive TUI to configure the task, select providers for each role, and set options before starting the orchestration loop.
You can seed TUI defaults from a JSON config file:
poly-weaver --config <path-to-config.json>Note: poly-weaver's auto-update of the agent CLIs (Claude Code, Codex CLI, GitHub Copilot CLI) currently supports only npm and winget as installation sources — an agent CLI is auto-updatable only if it was installed via npm or winget. Other installation sources are not supported. This applies to agent-CLI auto-update only, not poly-weaver's own self-update.
CLI options
| Option | Description | Default |
|---|---|---|
| --config <path> | Path to a JSON config file | (none) |
| -h, --help | Show help | |
| -V, --version | Show version | |
Workflow is selected with Shift+Tab in the TUI. Built-in workflows: default. Custom flows are also available.
