The reference
Every command,
by pillar.
The whole CLI, grouped by the six pillars. Commands flagged
plugin ship as separate repos.
fledge plugins install --defaults pulls the curated set.
The full flag-level docs live in the
canonical reference.
01
Scaffold
Get a project off the ground. Built-in and remote templates.
fledge templates init <name> | Create a new project from a template. |
fledge templates list | Show all templates (built-in, configured repos, local paths). |
fledge templates create <name> | Scaffold a new template directory with template.toml. |
fledge templates validate [path] | Check a template: manifest, Tera syntax, undefined vars, globs. |
fledge templates search [query] | Find templates on GitHub via the fledge-template topic. |
fledge templates publish [path] | Push a template directory to GitHub as a topic-tagged repo. |
02
Run
The task runner. Zero-config or fully declared in fledge.toml.
fledge run [task] | Run tasks. Auto-detect, or from fledge.toml. |
fledge lanes <run|list|init|…> | Manage and run composable workflow pipelines. |
fledge watch [task] | Re-run a task automatically when files change. |
03
Spec
Spec-sync. Specs are the source of truth for module design.
fledge spec check | Validate specs against code. --strict fails on warnings. |
fledge spec init | Set up spec-sync for the project. |
fledge spec new <name> | Scaffold a new spec. |
fledge spec list | List all specs. |
fledge spec show <name> | Show a specific spec's content. |
04
AI
Provider-agnostic over HTTP: Ollama, Anthropic, OpenAI, any gateway.
fledge ai <status|models|use> | Manage AI provider and model selection. |
fledge review | AI code review. --with-model for a multi-model panel. |
fledge ask <question> | Ask about your codebase. Spec-aware by default. |
05
Ship
Branch, commit, push, release. Conventional commits, AI messages.
fledge work <start|commit|push|status> | Git workflow for feature branches. |
fledge changelog | Generate a changelog from tags and conventional commits. |
fledge release <bump> | Bump version, changelog, git tag, optional push. |
fledge github issues [list|view|create] plugin | List, view, and create GitHub issues. |
fledge github prs [list|view|create] plugin | List, view, and create pull requests. |
fledge github checks plugin | CI/CD status for a branch. |
06
Extend
Plugins, config, introspection, diagnostics: the mechanism layer.
fledge plugins <install|remove|…> | Install, manage, and run community plugins. |
fledge config <get|set|…> | Manage ~/.config/fledge/config.toml. |
fledge doctor | Diagnose fledge / Git / AI / toolchain health. |
fledge introspect | Dump the full command tree as JSON for agents. |
fledge completions [shell] | Shell completions for bash, zsh, fish. |
fledge deps plugin | Cross-ecosystem dependency health (outdated / audit / licenses). |
fledge metrics plugin | Code metrics: LOC, churn, test ratio. Wraps tokei + git. |
The default plugin set
fledge plugins install --defaults installs the curated three:
# Curated set, installed in one shot
$ fledge plugins install --defaults
✓ fledge-plugin-github : checks, issues, prs
✓ fledge-plugin-deps : cross-ecosystem dependency health
✓ fledge-plugin-metrics : LOC, churn, test ratio
$ fledge plugins install --defaults
✓ fledge-plugin-github : checks, issues, prs
✓ fledge-plugin-deps : cross-ecosystem dependency health
✓ fledge-plugin-metrics : LOC, churn, test ratio