fledge 1.1.1

Dev lifecycle CLI. One tool for the dev loop, any language.
fledge-1.1.1 is not a library.

fledge

CI Crates.io Downloads License: MIT Docs

One CLI for the dev loop. Any language. JSON by default. Read the docs and go.

fledge templates init my-tool --template rust-cli
cd my-tool
fledge lanes run ci

Working with AI agents? See AGENTS.md. Every command emits {schema_version: 1, ...}, FLEDGE_NON_INTERACTIVE=1 silences prompts, fledge ask and fledge review are spec-aware, and fledge introspect --json dumps the full command tree. Works with Claude CLI or any Ollama endpoint (local, cloud, or self-hosted).

Install

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

fledge plugins install --defaults          # 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? cd into it, fledge auto-detects the stack:

fledge run test       # runs your language's test command
fledge run build      # same for build
fledge review         # AI code review against the default branch
fledge review --with-model ollama:gpt-oss:120b-cloud,ollama:qwen3-coder:480b-cloud
              # multi-model panel, parallel critiques on the same diff

Starting fresh? Scaffold from a template:

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

Switch AI providers without editing config:

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

The six pillars

Pillar Commands What it does
Scaffold templates (init, create, list, search, validate, publish) Start a project from a template, local or remote
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 and 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 is the whole core. Anything else is a plugin.

Plugins

Plugins extend fledge with community-built commands. Native plugins run as regular executables. WASM plugins run in a sandboxed Wasmtime runtime with no host access by default.

fledge plugins install --defaults          # curated native plugin set
fledge plugins create my-lint --wasm       # scaffold a sandboxed WASM plugin

Default plugins

Three native plugins ship as the default set:

Plugin Adds
fledge-plugin-github checks, issues, prs. GitHub PR/issue/CI flow
fledge-plugin-deps deps. Polyglot lockfile audits
fledge-plugin-metrics metrics. LOC, churn, test/source ratio (via tokei + git)

WASM plugins

WASM plugins are ideal for pure-computation tasks (linting, formatting, analysis) where you want strong isolation without trusting arbitrary binaries:

  • Sandboxed by default. No filesystem, no network
  • Opt-in capabilities prompted at install time
  • Fuel-bounded execution (no infinite loops)
  • 256 MB memory cap
  • Cross-platform single .wasm binary

See the WASM plugin guide for authoring details.

Built-in templates

rust-cli, ts-bun, python-cli, go-cli, ts-node, static-site, kotlin-kmp, kotlin-ktor-api

Browse community templates: fledge templates search <keyword>

Examples

  • Community templates. A growing collection covering Angular, Bun APIs, Deno CLIs, MCP servers, Rust workspaces, Swift packages, 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