🐦🔥 The substrate
One CLI for the
whole dev lifecycle.
Zero-config task runner, project scaffolding, AI review, and the
plugin protocol every CorvidLabs project shares. fledge lanes run verify is the single CI gate across Rust, Swift, TypeScript, Kotlin, Python, and Go.
Install
$ brew tap CorvidLabs/tap
$ brew install fledge
# From source (Rust)
$ cargo install --git https://github.com/CorvidLabs/fledge
# Verify
$ fledge --version
fledge 1.4.2
Six surfaces, one CLI
Task runner
fledge.toml declares named tasks; lanes compose them. Replaces ad-hoc Makefiles, npm scripts, and cargo make with one consistent shape across every language.
Plugin protocol
Third-party commands install by name, sandboxed via the fledge-v1 protocol. 40+ official plugins; community plugins compose freely. WASM-sandboxed plugins planned (canary-wasm prototype already proves the model).
AI review
fledge ai and fledge review tap multiple LLM providers (Anthropic, OpenRouter, Ollama). Code review, lane diagnostics, assisted task definition. Configure per-tier providers for cost / quality tradeoffs.
Spec validation
Lanes can run spec-check against module specs (via the spec-sync integration). Drift between code and *.spec.md files becomes a CI failure, not a code-review nag.
Scaffolding
fledge new from the official template collection. Rust binary, Rust library, Node/TS web service, Python package, Go service, Swift package, Obsidian plugin. Zero-config getting started.
Doctor + observability
fledge doctor checks your project's toolchain health, validates the config, surfaces missing dependencies. The first command a new contributor runs to verify their machine is ready.
Key concepts
The vocabulary; everything else composes from these.
- task
- A named shell command in
[tasks]offledge.toml - lane
- Ordered list of task names. E.g.
verify = ["fmt-check", "lint", "test", "spec-check"] - plugin
- A
fledge-v1-protocol subprocess installed viafledge plugins install - template
- A
fledge newscaffold - doctor
fledge doctorchecks toolchain health- lifecycle hook
- Plugins register
pre-lane/post-lane/pre-task/post-task
Plugin ecosystem
See all 40+ →Where it's used
Every CorvidLabs project runs fledge lanes run verify as its single CI gate.
- → corvid-chat 21 specs, fmt-check + clippy + test + spec-check lane
- → corvid-agent same pattern, TypeScript
- → Merlin built on top of the fledge plugin protocol
- → spec-sync spec-check lane consumer
- Every Swift / Rust repo in the CorvidLabs org
v1.4.2 just shipped
SemVer additive guarantees within v1. Plugin authors: your code keeps working.