TL;DR: Claude Code keeps evolving — and so does FAF. We took all the new Claude features (yep, they're keeping us busy!) and built an even better mirror to reflect CLAUDE.md for 2026. New detection engine, new preservation mode, 12 new tests.

What's New

Smart Content Detection

Bi-sync now recognizes custom markers in CLAUDE.md files:

## TOOLS        ← detected
## ENDPOINTS    ← detected
## AUTH         ← detected
## COMMANDS     ← detected
| Tool |        ← markdown table
```bash        ← code block

When these markers appear, bi-sync knows the file has been customized.

Preservation Mode

For custom files, bi-sync switches to preservation mode:

CUSTOM CONTENT DETECTED

Preserve entire CLAUDE.md
Update sync footer only
Maintain full context link

Your hand-crafted documentation stays intact. The sync footer confirms the link to your .faf file.

Improved Path Resolution

FAFMirror now uses findFafFile() for smarter path resolution — correctly locating project.faf in all scenarios.

The Rule

Score Can Only Improve

Context quality goes up. Never down.

Use Cases

Standard Workflow

The classic flow works exactly as before:

faf init
faf auto
faf bi-sync

Full bidirectional sync. Your .faf and CLAUDE.md stay perfectly mirrored.

Power User Workflow

For custom MCP servers, API documentation, or specialized tooling:

faf init
# Customize CLAUDE.md with tables, endpoints, etc.
faf bi-sync

Bi-sync detects your customizations and preserves them.

Try It

npm install -g faf-cli@3.4.8

Or update:

npm update -g faf-cli

GitHub

View the source and release notes.

v3.4.8 Release

npm

Install the latest version.

faf-cli

The Numbers

v3.4.8 - Released January 18, 2026
586/586 - Tests passing (+12 new)
100% - Trophy score 🏆
WJTTC GOLD - Certified 🥇
15,000+ - npm downloads