fledge-plugin-stats

Example plugin demonstrating the fledge-v1 protocol. Shows project statistics including file counts, lines of code, git history, and change tracking between runs.

Protocol features used

• log — status messages during analysis
• progress — 5-step progress bar
• exec — runs shell commands (find, git, wc)
• metadata — fetches git_status and git_tags
• store / load — persists stats between runs for delta tracking
• output — renders a formatted stats card

Install

# Install from GitHub:
fledge plugin install CorvidLabs/fledge-plugin-stats

# Or clone and install locally:
git clone https://github.com/CorvidLabs/fledge-plugin-stats.git
fledge plugin install ./fledge-plugin-stats

Usage

fledge stats

Example output

  ╭─────────────────────────────────────────╮
  │  fledge           stats                 │
  ├─────────────────────────────────────────┤
  │  Language    rust                        │
  │  Files          142 (+3)                │
  │  LOC          12847 (+215)              │
  │  Commits        287                     │
  │  Test files      12 (8%)               │
  ├─────────────────────────────────────────┤
  │  Rust               38                  │
  │  Markdown           22                  │
  │  TOML                8                  │
  │  Other              74                  │
  ├─────────────────────────────────────────┤
  │  Top contributors                       │
  │    42  Corvid Agent                     │
  │    18  Leif                             │
  ├─────────────────────────────────────────┤
  │  Recent commits                         │
  │    abc1234 fix: plugin protocol test    │
  │    def5678 feat: add lanes pipeline     │
  ╰─────────────────────────────────────────╯

Development

cargo build --release
cargo clippy -- -D warnings
cargo fmt --check

CI runs on every push and PR via GitHub Actions (.github/workflows/ci.yml).

Zero dependencies

This plugin uses only the Rust standard library — no external crates. JSON is handled via simple string helpers, making it a minimal reference implementation of the fledge-v1 protocol.