fledge

fledge: one Rust binary, six pillars, spec-driven by default. Templates scaffold, lanes run, plugins extend, spec-sync keeps the docs honest about the code — and any LLM drives the same CLI you do.

fledge templates init my-tool --template rust-cli
cd my-tool
fledge lanes run ci  # lint + test + build, works out of the box

Working with AI agents? fledge has a first-class agent surface: every read command exposes --json, FLEDGE_NON_INTERACTIVE=1 silences every prompt, fledge ask and fledge review are automatically spec-aware, and fledge introspect --json dumps the full command tree. Works with Claude CLI or any Ollama-speaking endpoint (local, cloud, or self-hosted). See AGENTS.md for the one-page guide.

Install

cargo install fledge                       # from crates.io
brew install CorvidLabs/tap/fledge         # homebrew

fledge plugins install --defaults          # one line to install the curated plugin set

curl -fsSL https://raw.githubusercontent.com/CorvidLabs/fledge/main/install.sh | sh
nix run github:CorvidLabs/fledge
git clone https://github.com/CorvidLabs/fledge.git && cd fledge && cargo install --path .

Quick Start

Already have a project? Just use it — fledge auto-detects your stack:

fledge run test       # runs your language's test command
fledge run build      # same for build
fledge review         # single-model AI code review
fledge review --with-model ollama:gpt-oss:120b-cloud,ollama:qwen3-coder:480b-cloud
              # multi-model panel — same diff, parallel critiques, one merge decision

Starting fresh? Scaffold from a template:

fledge templates init my-app --template rust-cli     # built-in template
fledge templates init my-app --template user/repo    # any GitHub repo
fledge templates init my-app                         # interactive picker

Switch AI providers in one line:

fledge ai use                                  # interactive picker (live model list for Ollama)
fledge ai use ollama qwen3-coder:480b-cloud    # scriptable
fledge ai status                               # shows provider, model, and where each value came from

The Six Pillars

That's the whole core. Anything else is a plugin. See fledge plugins install --defaults below.

Default Plugins

The plugins that took over commands removed from core in v0.15. Install all five with one command:

fledge plugins install --defaults

Why split them out? Because not every fledge user is on GitHub or runs a polyglot project. The core stays tight; you opt in to what you need.

(fledge-plugin-templates-remote and fledge-plugin-doctor were dropped from the default set in v0.15.2 and re-absorbed into core: fledge templates search/publish and the Toolchains section of fledge doctor. The standalone plugin repos still exist but are no longer part of --defaults.)

Built-in Templates

rust-cli · ts-bun · python-cli · go-cli · ts-node · static-site

Browse community templates with the remote-templates plugin: fledge templates-search <keyword>

Examples

• Community Templates — 18 ready-to-use templates (angular-app, bun-api, deno-cli, mcp-server, rust-workspace, swift-pkg, and more)
• Example Lanes — language-specific CI/CD pipelines
• Example Plugin — deploy/rollback plugin reference

Learn More

• Full Documentation — commands, configuration, guides
• Template Authoring — create and publish your own templates
• Lanes Guide — task pipelines and workflow automation
• Plugins Guide — extend fledge with community tools

Contributing

See CONTRIBUTING.md for development setup, guidelines, and how to submit changes.

Security

See SECURITY.md for the security policy and how to report vulnerabilities.

License

MIT