fledge 0.8.0

Dev-lifecycle CLI — scaffolding, tasks, flows, plugins, and more.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# fledge

[![CI](https://github.com/CorvidLabs/fledge/actions/workflows/ci.yml/badge.svg)](https://github.com/CorvidLabs/fledge/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/fledge)](https://crates.io/crates/fledge)
[![Downloads](https://img.shields.io/crates/d/fledge)](https://crates.io/crates/fledge)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-brightgreen)](https://corvidlabs.github.io/fledge/)

**One CLI, your whole dev lifecycle.** Scaffold, build, review, ship — zero config for the common case.

```bash
fledge init my-tool --template rust-cli
cd my-tool
fledge flow ci     # lint + test + build, works out of the box
```

## Install

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

<details>
<summary>More install options</summary>

```bash
cargo install fledge --features tui   # with TUI browser
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 .
```

</details>

## Quick Start

**Already have a project?** Just use it — fledge auto-detects your stack:

```bash
fledge run test       # runs your language's test command
fledge run build      # same for build
fledge review         # AI code review via Claude
```

**Starting fresh?** Scaffold from a template:

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

## What's Inside

| Stage | Commands | What it does |
|-------|----------|-------------|
| **Start** | `init`, `list`, `search`, `create-template` | Scaffold projects from local or remote templates |
| **Build** | `run`, `flow`, `config`, `doctor` | Task runner, workflow pipelines, environment checks |
| **Develop** | `work`, `spec` | Feature branches, PRs, spec-sync |
| **Review** | `review`, `ask`, `metrics`, `deps` | AI code review, codebase Q&A, health checks |
| **Ship** | `issues`, `prs`, `checks`, `changelog` | GitHub integration, CI status, release notes |
| **Extend** | `plugin`, `completions`, `tui` | Community plugins, shell completions, TUI browser |

## Built-in Templates

`rust-cli` · `ts-bun` · `python-cli` · `go-cli` · `ts-node` · `static-site`

Browse community templates: `fledge search <keyword>`

## Examples

- **[Official Templates](https://github.com/CorvidLabs/fledge-templates)** — hello-world, bun-api, ts-lib, and more
- **[Example Flows](https://github.com/CorvidLabs/fledge-flows)** — language-specific CI/CD pipelines
- **[Example Plugin](https://github.com/CorvidLabs/fledge-deploy)** — deploy/rollback plugin reference

## Learn More

- **[Full Documentation](https://corvidlabs.github.io/fledge/)** — commands, configuration, guides
- **[Template Authoring](https://corvidlabs.github.io/fledge/template-authoring.html)** — create and publish your own templates
- **[Flows Guide](https://corvidlabs.github.io/fledge/flows.html)** — task pipelines and workflow automation
- **[Plugins Guide](https://corvidlabs.github.io/fledge/plugins.html)** — extend fledge with community tools

## License

MIT