flywheel-setup

Installs and configures agent-flywheel prerequisites including br, bv, ntm, and agent-mail.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill flywheel-setup-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flywheel-setup
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/flywheel-setup
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill flywheel-setup-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the agent-flywheel multi-agent coding workflow requires many external CLI tools and services (br, bv, ntm, dcg, cass, cm, agent-mail), and manually checking, installing, registering, and verifying each one is error-prone and tedious. ## Core Features & Use Cases - Parallel pre-flight detection: Runs all install-state probes at once via detectInstallState and renders a single batched install plan with one consent prompt instead of per-tool questions. - Tiered tool installation: Handles required tools (br, bv, agent-mail), recommended tools (ntm, dcg, cass, cm), and optional tools, with an ACFS stack shortcut when three or more are missing. - Post-flight verification: Automatically runs the flywheel_doctor health sweep after setup and prints a tiered checklist plus glossary so the operator knows the environment is ready. - Use Case: After installing the agent-flywheel plugin in a fresh project, run this Skill to detect missing tools, install them with consent, register the Orchestrator agent in agent-mail, and confirm all required checks pass before starting the flywheel loop. ## Quick Start Run /agent-flywheel:flywheel-setup in my project to detect, install, and verify all flywheel prerequisite tools.

Frequently Asked Questions about flywheel-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the agent-flywheel prerequisites in a new project?

Run the flywheel-setup skill, which detects missing tools in parallel, presents a single batched install plan, and installs required tools like br, bv, and agent-mail with your consent. It finishes by running the doctor health check to confirm everything works.

What tools does agent-flywheel require to run?

The required tools are br (bead tracker), bv (bead viewer), and agent-mail for multi-agent coordination. Recommended tools include ntm for parallel agent sessions, dcg for destructive command guarding, and cass and cm for session search and memory.

Does flywheel-setup install everything automatically without asking?

No. Every installation requires explicit user consent through an AskUserQuestion prompt. On refusal, the skill prints the manual install command and continues with the remaining checks.

Why does ntm fail to spawn sessions for my project after installation?

ntm resolves project names under its configured projects_base directory, so your current project must exist there. The skill detects this mismatch and offers to symlink your project into projects_base or change the base path.

What happens if a setup step fails during the batch install?

The batch executor does not abort on failure; it returns per-step results. For each failure you can choose to retry the step, skip it and continue, or abort the batch and re-run setup later.

Should I use the Rust or Python version of agent-mail?

The Rust port (mcp_agent_mail_rust) is the primary distribution and is installed by default. The legacy Python version still works over the same HTTP transport, but the skill recommends migrating to the Rust binary.