TL;DR: We ran faf git against 100 of the most famous repositories on GitHub — React, Bitcoin, PyTorch, Linux, VS Code. Every single one got an accurate, compact project.faf. Language detection, install method, build system — all correct. That's the bar now.

What Changed

Compact Output

The old faf git produced ~130 lines of YAML. Most of it was noise — empty slots, placeholder values, internal directives that should never have been in the output.

v4.4.4 produces ~35 lines. Only the fields that matter. Clean header, real data, nothing else.

Before (v4.4.2)

main_language: Unknown
slotignored: true
context:
  how: npm install (see README)
  # ...130 lines of noise

After (v4.4.4)

# project.faf — Machine-readable project context
project:
  name: react
  description: The library for web UIs
  language: JavaScript
  type: library
stack:
  runtime: Node.js
  build: Rollup
  test: Jest
  package_manager: npm

Language Detection That Actually Works

The GitHub API returns languages sorted by byte count. v4.4.4 uses the primary language (first in the sorted array) instead of pattern-matching. React is JavaScript, not TypeScript. Bitcoin is C++, not Shell. Linux is C, not Assembly.

17 languages supported with correct runtime mapping:

TypeScript JavaScript Python Rust Go C++ C Java Ruby Swift Kotlin Zig Lua Dart PHP Scala Elixir

Language-Aware Install Detection

The install command now reflects the actual ecosystem:

Python: pip install (see README) Rust: cargo install (see README) Go: go install (see README) Node.js: npm install (see README) Docker: docker pull (see README)

The Hundred Repos

We generated project.faf files for 100 top GitHub repositories. Every one was verified for accuracy:

react JavaScript

bitcoin C++

pytorch Python

linux C

vscode TypeScript

rust Rust

tensorflow C++

kubernetes Go

...and 92 more. All correct. All compact. All PR-ready.

Try It

npm install -g faf-cli@4.4.4

Generate a .faf for any GitHub repo:

faf git facebook/react faf git bitcoin/bitcoin faf git torvalds/linux

GitHub

Source and release notes.

v4.4.4 Release

npm

Install the latest version.

faf-cli

The Numbers

v4.4.4 - Released February 18, 2026
885/885 - Tests passing (+86 new)
100 - Famous repos scored
17 - Languages detected
~35 lines - Average output (was ~130)