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
At least one supported agent CLI installed and authenticated:

npm install -g poly-weaver

Usage

poly-weaver

This 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.

License

MIT