The repo-native record of intent and approvals for AI-assisted engineering — validated, attributable, readable by any agent.
WingFoil keeps your project's intent in git — tasks, specs, ADRs, decision logs, bugs — as typed documents with their own state machines. Every approval records who decided and why, in the commit. It works alongside the spec-driven tools and coding agents you already use, through a CLI and an MCP server.
npm install -g wingfoil
wingfoil init --template Scrumflowchart LR
T["wingfoil-templates<br/>packs"] --> W["wingfoil<br/>CLI + MCP"]
W --> Y["your project"]
B["wingfoil-benchmark<br/>measurements"] --> W
U["wingfoil-ui<br/>local web console"] --> Y
Y -. "feedback notes" .-> W
| Repository | What it is | Latest |
|---|---|---|
| wingfoil | The core: CLI + MCP server — Memory, DNA, Directives, Workflows | npm 0.2.2 |
| wingfoil-templates | Versioned packs of templates, methodologies and directives that WingFoil consumes | no pack published yet |
| wingfoil-ui | Local web console for WingFoil-governed projects: read a project's Memory, DNA, directives and team in the browser | v0.1.0 · not on npm, run from a checkout |
| wingfoil-benchmark | Measures where WingFoil makes a difference, against plain agents and other tools | v0.1 results |
More: how the repositories relate.
- 📚 For users — packages, guides, releases and benchmark results
- 🤖 For AI agents — MCP server and the files written for agents
- 🔁 Feed back into WingFoil — how a project using WingFoil reports defects and requests, and learns which release answered them
- 💬 Discussions — questions and ideas
- 🐞 Issues — bugs and proposals
- 🤝 How to contribute — through Memory, not (only) code
- Every repository listed above is governed with WingFoil itself: its Memory is public under
docs/. - The benchmark is built by WingFoil's maintainer: its rules are fixed before any run, losses are published like wins, and every run's record, cost and transcript are public.
- Security reports: see SECURITY.md.
- All repositories are MIT licensed.
