▄▄       ▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █
  ████      ▀▀█▄  █  █ █   █▀▄  █
██████      ▄▄▄▀  █  █ ▀▀▀ █ █  █
████████
████████    █▀▄  █ █ █▀▄   ▀▀█ █ ▄▀▀
 ██████     ██▀  █ █ █ █   ▄ ▀ █ █ ▄
   ████     █▄▀  ▀▄▀ █ █   █▄▄ █ ▀▀█
     ▀▀
  

bun-sticky

Fastest bun under the sum.
Zig-native FAF CLI. Zero dependencies. Wolfejam slot-based scoring.

Install • Usage • Scoring • Tiers • Contributing

---

Install

curl -fsSL https://raw.githubusercontent.com/Wolfe-Jam/bun-sticky-zig/main/install.sh | bash

Or build from source:

git clone https://github.com/Wolfe-Jam/bun-sticky-zig
cd bun-sticky-zig
./verify

77KB binary. Zero runtime dependencies.

Bun is built on Zig ⚡️ — so we did that too. Also available as a TypeScript package on npm — 1,100+ downloads.

Usage

cd any-project        # Go to any repo/directory
faf score             # Score the project.faf

Or create one:

faf init myapp        # Create project.faf
faf score             # Score it
faf sync              # Sync to CLAUDE.md
faf help              # Show commands

Why Zig?

Bun is built on Zig. This CLI speaks Bun's native language.

Feature	bun-sticky
Binary size	77KB
Dependencies	0
Cold start	<1ms
Cross-platform	✓

Scoring

Wolfejam Slot-Based Scoring - 21 slots across 5 categories:

Category	Slots	Fields
Project	3	name, goal, main_language
Frontend	4	frontend, css_framework, ui_library, state_management
Backend	5	backend, api_type, runtime, database, connection
Universal	3	hosting, build, cicd
Human	6	who, what, why, where, when, how

Type-aware: CLI uses 9 slots, Fullstack uses all 21.

Score = Filled Slots / Applicable Slots × 100

Tiers

Score	Tier
105%	Big Croissant	🥐 AI-awarded excellence
100%	Trophy	🏆
99%+	Gold	🥇
95%+	Silver	🥈
85%+	Bronze	🥉 Production ready
70%+	Green	🟢
55%+	Yellow	🟡
<55%	Red	🔴

Big Croissant (🥐 105%) - The Michelin Star for repos. Can't be calculated - awarded by AI/human for excellence beyond the slots.

Testing

zig build test --summary all    # 136/136 tests passed

FAF Ecosystem

Package	Runtime	Install
faf-cli	Node.js	npm i -g faf-cli
bun-sticky-faf	Bun	bunx bun-sticky-faf
bun-sticky-zig	Native	curl -fsSL .../install.sh | bash
bun-sticky-zig-plus	Native	Color ASCII, bi-sync, --json (paid)

Best Context Under the Bun

faf-cli v5.0.6 aligned the full FAF toolchain with Bun as a first-class runtime. bun-sticky-zig is the technical credibility layer beneath it all — a pure Zig parser running native inside the ecosystem that Bun itself is built on.

Bun chose Zig. This parser speaks that same language. No transpilation, no runtime, no dependencies. Just Zig reading YAML at the speed of the metal.

For the full CLI toolchain — init, auto, go, bi-sync, tri-sync, and 30+ commands — run:

bunx faf-cli auto       # Zero to 100% in one command, native on Bun
bunx faf-cli init       # Create .faf from your local project
bunx faf-cli go         # Guided interview to gold code

bun-sticky-zig is the Zig showcase: proof that FAF parses at the lowest level of the stack. faf-cli is the full toolchain: everything you need to score, sync, and ship.

Read more: Best Context Under the Bun — the full story on FAF + Bun alignment.

License

MIT

---

Zero dependencies. Pure Zig. Wolfejam slot-based scoring.
The poster child FAF CLI for Bun/Anthropic.