ZERO-DEPENDENCY GIT HOOK

NEVER EXPLAIN
GIT MERGES
TO YOUR IDE AGENT

Briefed is an ultra-lightweight Node.js CLI hook. It runs instantly during post-merge and post-rewrite to diff pulled changes, compile a rich summary using local Ollama or cloud LLMs, and atomically write to your assistant's context (CLAUDE.md) in milliseconds. Keeps your IDE assistant perfectly aligned.

briefed-init.sh

active

$ ■

NO MORE MANUAL CONTEXT DUMPS ⚡ RECURSIVE PATHSPEC SHIELD ⚡ ATOMIC BUFFER SWAP SAFETY ⚡ OLLAMA, GEMINI & CLAUDE Backends ⚡ CLIENT-SIDE SECRET SCRUBBER ⚡ WINDOWS CRLF HOOK AUTO-SANITIZER ⚡ NO MORE MANUAL CONTEXT DUMPS ⚡ RECURSIVE PATHSPEC SHIELD ⚡

THE ENGINE ARCHITECTURE

RECURSIVE DIFF SHIELD

Briefed natively appends Git pathspec exclusions (:(exclude)CLAUDE.md) so updates to the target file itself never contaminate subsequent diffs. Your LLM never gets recursively confused by previous context summaries.

ATOMIC WRITING & LOCKS

Engineered with active file locks (CLAUDE.md.lock) and atomic temporary buffer swaps (renameSync) to guarantee zero context file corruption, even during high-frequency parallel merge actions.

SECURE TOKEN SCRUBBER

Protects team projects by scanning git diffs locally and scrubbing database connection strings, AWS credentials, bearer tokens, SSH keys, and API secrets before sending data payloads to cloud LLMs.

LIVE HOOK SIMULATOR

Simulate Git events to see how Briefed automatically compiles structural summaries, scrubs secrets, and injects context blocks in real-time!

GIT EVENT EMULATOR

FEATURE feature/auth-oauth2

Implement OAuth2 Security Flow

Adds secure login endpoints in /src/auth.ts and deletes deprecated raw secret tables.

DEPENDENCIES patch/upgrade-deps

Upgrade UI Core Packages

Installs chalk and upgrades vitest to version 1.6 in package.json.

BUGFIX hotfix/windows-crlf

Resolve Windows CRLF Hook Bug

Modifies post-merge hook in src/hook.ts to force Unix LF line-endings.

Sync Active

THE CONFIGURATION BOARD

Click and rotate dials, toggle options, or slide bars below to see how Briefed parses your parameters and compiles the final .briefed.json configuration in real-time!

1. TARGET RESOLVER

Where should Briefed dump its context entries? Auto-detection priorities scan for files in order.

AUTO CLAUDE.md AGENTS.md

Resolved target: CLAUDE.md

2. LLM BACKEND

Choose the summarization brain. Ollama runs local and free. Gemini and Claude run cloud-accelerated.

Active Backend: ollama

3. ROLLING WINDOW

Prune older entries automatically based on dates. Prevents unbounded context growth and token bloat.

1 Day

30 Days

Window Limit: 7 Days

4. SMART SKIP THRESHOLD

If git diff line count is below this dial limit, it skips the LLM and runs a mechanical summary instantly.

Skip under: 10 Lines

.briefed.json — LIVE TELEMETRY

PARSER ACTIVE

UPGRADE YOUR AI WORKFLOW INSTANTLY

Zero configuration, zero dependencies, total context alignment. Briefed is open for local community testing.

NEVER EXPLAIN GIT MERGES TO YOUR IDE AGENT