fledge 0.15.1

Dev-lifecycle CLI — scaffolding, tasks, lanes, plugins, and more.
fledge-0.15.1 is not a library.

fledge

CI Crates.io Downloads License: MIT Docs

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

Pillar Commands What it does
Scaffold templates (init, create, validate, list) Local templates pillar — start any project
Run run, lanes, watch Task runner, composable pipelines, file-watch reruns
Spec spec spec-sync — modules declare their contract; AI uses it as context
AI ai, ask, review Provider+model selection, spec-aware Q&A, single- and multi-model code review
Ship work, release, changelog Branch + PR flow with AI-drafted bodies, version bump, tag, push
Extend plugins, config, introspect, completions, doctor Plugin protocol, global config, command-tree introspection, env health

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
Plugin Adds Replaces (pre-v0.15)
fledge-plugin-github checks, issues, prs the GitHub-specific browsing trio
fledge-plugin-deps deps polyglot lockfile audits
fledge-plugin-metrics metrics LOC/churn/test-ratio (now via tokei + git)
fledge-plugin-templates-remote templates-search, templates-publish GitHub template registry
fledge-plugin-doctor doctor-tools toolchain probes (rust/node/python/swift/...)

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

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

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