Skip to content

The substrate

One CLI for the
whole dev lifecycle.

The dev loop for any language, JSON by default: scaffold, run, review, and ship without the bash spaghetti. fledge lanes run verify is the single CI gate across Rust, Swift, TypeScript, Kotlin, Python, and Go.

Install fledge → GitHub ↗ Browse plugins →

One CLI, six pillars

The whole core, in one binary.

Every CorvidLabs project, in every language, runs the same handful of commands. That is the entire core. Anything else is a plugin.

Scaffold

templates

fledge templates init my-app --template rust-cli from a built-in template, or --template user/repo from any GitHub repo. Built-ins cover rust-cli, ts-bun, python-cli, go-cli, ts-node, static-site, kotlin-kmp, and kotlin-ktor-api.

Run

run, lanes, watch

fledge run test auto-detects your stack and runs the right command. fledge lanes run verify composes tasks into one gate. fledge watch test reruns on file changes.

Spec

spec

fledge spec check runs spec-sync: modules declare their contract in *.spec.md, and the AI commands use it as context. Drift becomes a CI failure, not a review nag.

AI

ai, ask, review

fledge review runs an AI code review against the default branch. fledge ask answers questions about your codebase. Pick providers with fledge ai use: Anthropic, any OpenAI-compatible endpoint, or Ollama.

Ship

work, release, changelog

fledge work drives the branch and PR flow with AI-drafted bodies. fledge release minor --push bumps the version, writes the changelog, tags, and pushes.

Extend

plugins, config, doctor, introspect, completions

fledge plugins install --defaults adds the curated set. fledge doctor checks toolchain health. fledge introspect --json dumps the whole command tree for agents.

The dev loop

One gate. Every language.

A lane composes named tasks into an ordered pipeline. fledge lanes run verify is the one gate every repo shares, whether the underlying stack is Rust, Swift, TypeScript, Kotlin, Python, or Go. CI runs exactly what you run locally.

fledge.toml

[tasks]
fmt-check = "cargo fmt --check"
lint = "cargo clippy -- -D warnings"
test = "cargo test"

[lanes]
verify = ["fmt-check", "lint", "test", "spec-check"]

In CI and on your machine

$ fledge lanes run verify
→ verify (4 steps)
✓ fmt-check 120ms
✓ lint 3.4s
✓ test 18.1s
✓ spec-check 240ms
→ verify passed in 21.9s

# Plan only, no execution
$ fledge lanes run verify --dry-run

fledge run test

Auto-detects the stack and runs your language's test command. No config required.

fledge watch test

Re-runs a task or lane on file changes, with a debounce and optional extension filter.

fledge run test --json

Every command emits structured JSON, so agents and tooling parse results directly.

Key concepts

The vocabulary; everything else composes from these.

task
A named shell command in [tasks] of fledge.toml. fledge run executes it.
lane
An ordered list of task names. verify = ["fmt-check", "lint", "test", "spec-check"].
plugin
A command installed via fledge plugins install . Native or WASM.
template
A fledge templates init --template scaffold, built-in or from GitHub.
lifecycle hook
Plugins register pre-lane / post-lane / pre-task / post-task steps.
provider
An AI backend chosen with fledge ai use: Anthropic, OpenAI-compatible, or Ollama.

The plugin protocol

Extend the CLI without trusting a binary.

Plugins add commands by name. Native plugins run as regular executables. WASM plugins ship too: they run in a fuel-metered Wasmtime sandbox over WASI, with no host access until you grant it. Ideal for pure-computation tasks like linting, formatting, and analysis where you want strong isolation.

Install and scaffold

# Curated default set: github, deps, metrics
$ fledge plugins install --defaults

# Any GitHub repo, pinned to a ref
$ fledge plugins install CorvidLabs/fledge-plugin-github

# Scaffold a sandboxed WASM plugin
$ fledge plugins create my-lint --wasm

# Inspect what is installed
$ fledge plugins audit

The WASM sandbox

  • Sandboxed by default. No filesystem, no network. The plugin sees nothing it was not granted.
  • Opt-in capabilities. Any access is prompted at install time and recorded in the plugin manifest.
  • Fuel-bounded. Wasmtime meters execution by fuel, so a runaway plugin cannot loop forever.
  • 256 MB memory cap. A hard ceiling on the linear memory each plugin instance can allocate.
  • Single .wasm binary. wasm32-wasip1 output runs cross-platform with no per-OS build matrix.
  • Audit on demand. `fledge plugins audit` lists every installed plugin's trust tier, capabilities, and hooks.

The registry

46 official plugins

Live from the CorvidLabs org. Search by name or description, filter by tier and language, then copy the install command. Every plugin composes on the same fledge-v1 protocol.

  • hub 2

    🏠 Local web dashboard for browsing and managing fledge templates, plugins, lanes, and config

    official JavaScript
    fledge plugins install CorvidLabs/fledge-plugin-hub
  • github 2

    🐙 GitHub commands for fledge. Checks, issues, PRs via the gh CLI.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-github
  • weather 2

    🌤️ Terminal weather reports powered by Open-Meteo

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-weather
  • standup 2

    📝 Markdown standup post from your recent git commits, narrated by the active fledge LLM

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-standup
  • roast 2

    🔥 Roast a commit through the active fledge LLM provider. Entertainment purposes only.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-roast
  • bench 1

    ⏱️ Run benchmarks, save a baseline, and flag regressions

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-bench
  • deps 1

    📦 Cross-ecosystem dependency health for fledge. Outdated, audit, licenses across Rust, Node, Python.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-deps
  • secrets 1

    Scan your codebase for leaked secrets, API keys, tokens, passwords, private keys. Kotlin fledge plugin.

    official Kotlin
    fledge plugins install CorvidLabs/fledge-plugin-secrets
  • coverage 1

    📈 Run language-native test coverage and gate on a threshold

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-coverage
  • figma 1

    🎨 Sync Figma design tokens, export component specs, and diff design changes

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-figma
  • dashboard 1

    Interactive web dashboard plugin for fledge

    official HTML
    fledge plugins install CorvidLabs/fledge-plugin-dashboard
  • canary 1

    🐤 Native security canary. Probes what an untrusted plugin can access.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-canary
  • hangman 1

    🎮 Hangman with identifiers from your codebase

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-hangman
  • gitleaks 1

    🔒 Scan your repo for committed secrets via gitleaks, with a one-command pre-commit hook installer

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-gitleaks
  • discord 1

    💬 Discord webhook plugin for CI failure notifications

    official TypeScript
    fledge plugins install CorvidLabs/fledge-plugin-discord
  • metrics 1

    🔢 Code metrics for fledge. LOC, churn, test ratio. Wraps tokei and git.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-metrics
  • speedtest 1

    ⚡ Measure download and upload bandwidth via Cloudflare's speed test endpoints

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-speedtest
  • canary-wasm 1

    🛡️ WASM security canary. Proves the Wasmtime sandbox blocks every attack the native canary exposes.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-canary-wasm
  • e2e 1

    🧪 End-to-end test plugin. Exercises every command and reports pass or fail.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-e2e
  • env 0

    🔧 Check, list, and diff project .env files against .env.example

    official Python
    fledge plugins install CorvidLabs/fledge-plugin-env
  • bridge 0

    🌉 Dev environment bridge. Connect your machine to a remote agent session over WebSocket.

    official Kotlin
    fledge plugins install CorvidLabs/fledge-plugin-bridge
  • color 0

    🎨 Color palette helpers for fledge. Convert, preview, generate.

    official HTML
    fledge plugins install CorvidLabs/fledge-plugin-color
  • pg 0

    Postgres database management as fledge pg: query and schema over psql, with destructive-statement safety. Sibling of fledge-plugin-sql.

    official Python
    fledge plugins install CorvidLabs/fledge-plugin-pg
  • hello 0

    👋 Example fledge plugin (bash) demonstrating the fledge-v1 protocol

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-hello
  • sql 0

    🗃️ SQLite management plugin. Init, migrate, query, schema.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-sql
  • example 0

    Example fledge plugin demonstrating command extension and lifecycle hooks

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-example
  • localnet 0

    ⛓️ Algorand localnet lifecycle plugin. Start, stop, reset, fund, accounts.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-localnet
  • algochat 0

    💬 Encrypted on-chain messaging. AlgoChat via Algorand.

    official TypeScript
    fledge plugins install CorvidLabs/fledge-plugin-algochat
  • attest 0

    🔏 Record and verify signed provenance as `fledge attest`: who reviewed which commit, kept in git notes.

    official Swift
    fledge plugins install CorvidLabs/fledge-plugin-attest
  • doctor 0

    Toolchain diagnostics for fledge, extends fledge doctor with rust/node/python/swift/etc. probes

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-doctor
  • tz 0

    🕒 Timezone utility for fledge. Show, convert, and manage saved zones across distributed teams.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-tz
  • deploy 0

    🚀 Example fledge plugin with deploy, rollback, and lane hooks for plugin authors.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-deploy
  • stats 0

    📊 Example fledge plugin showing project statistics using the fledge-v1 protocol.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-stats
  • http 0

    Authenticated HTTP/REST client as fledge http, with SSRF guards. Complements fledge-plugin-web.

    official Swift
    fledge plugins install CorvidLabs/fledge-plugin-http
  • port 0

    📡 Find and kill processes bound to a TCP port. Friendlier lsof and netstat wrapper.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-port
  • scratch 0

    ✏️ Throwaway scratch notes scoped to your current repo. Opens in $EDITOR, autosaved per-repo.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-scratch
  • docker 0

    🐳 Docker build, push, and compose helpers wired to your project

    official Python
    fledge plugins install CorvidLabs/fledge-plugin-docker
  • augur 0

    🔮 Score a diff's change risk as `fledge augur`: proceed, review, or block, for humans and agents.

    official HTML
    fledge plugins install CorvidLabs/fledge-plugin-augur
  • jwt 0

    🔑 JWT encode, decode, and verify from fledge

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-jwt
  • memory 0

    🧠 Three-tier memory plugin. Ephemeral SQLite, mutable ARC-69, permanent on-chain.

    official TypeScript
    fledge plugins install CorvidLabs/fledge-plugin-memory
  • todo 0

    📋 Extract TODO/FIXME/HACK/XXX comments from your codebase

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-todo
  • apple-music 0

    🎧 Apple Music controls for fledge. Play, pause, skip, search, and browse your library from the terminal.

    official Swift
    fledge plugins install CorvidLabs/fledge-plugin-apple-music
  • bridge-client 0

    🌉 Bridge client for fledge. Read and write files on connected bridge sessions.

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-bridge-client
  • templates-remote 0

    Remote template registry for fledge, search GitHub for community templates, publish your own

    official Shell
    fledge plugins install CorvidLabs/fledge-plugin-templates-remote
  • hello-rust 0

    🦀 Example fledge plugin in Rust. Demonstrates the fledge-v1 protocol.

    official Rust
    fledge plugins install CorvidLabs/fledge-plugin-hello-rust
  • hello-swift 0

    🍎 Example fledge plugin in Swift. Demonstrates the fledge-v1 protocol.

    official Swift
    fledge plugins install CorvidLabs/fledge-plugin-hello-swift

Where it's used

Every CorvidLabs project runs fledge lanes run verify as its single CI gate.

  • → corvid-chat 23 specs, fmt-check + clippy + test + spec-check lane
  • → Merlin built on top of the fledge plugin protocol
  • → spec-sync the spec-check lane consumer
  • Every Swift and Rust repo in the CorvidLabs org

v1.5.1 is live

v1.5.1 shipped 4 days ago (Jun 11, 2026).

SemVer additive guarantees within v1. Plugin authors: your code keeps working.

Install fledge Releases ↗ Other projects →