v2.0.2

Developer tools built for AI workflows.

Focused for AI consumption: structured, deterministic outputs that feed assistants, agents, and automation. Local-first. Privacy-focused. Fast.

Explore Products GitHub
Scroll
AI-Ready / Structured / Context-Rich / Deterministic / Local-First / Fast / AI-Ready / Structured / Context-Rich / Deterministic / Local-First / Fast /
[products]

Tools for AI-augmented teams

flagship

Branch Narrator

v0.9.0

Local-first CLI that reads your git diff and generates structured, AI-ready PR descriptions. 28 specialized analyzers. 8 framework profiles. Zero network calls.

28 Analyzers
8 Profiles
0 Network
View Source Learn More
zsh
$ npx branch-narrator integrate
# analyzing changes...
+ detected sveltekit profile
+ found 12 route changes
+ identified 3 breaking changes
+ generated pr description
$

More Tools

Building more developer tools. Stay tuned.

coming soon

Collaborate

Open to collaboration. Let's build together.

get in touch
[why]

Branch Narrator

AI workflows need grounded, structured change context. We generate machine-readable summaries with evidence.

AI-Ready Output

Structured summaries and JSON built for assistants, agents, and automation. Consistent, machine-friendly signals.

Local-First

Private by default. Your code never leaves your machine. Works offline, air-gapped, and safe for sensitive repos.

Fast

Analyze thousands of lines in milliseconds. No API latency, no rate limits.

Framework Aware

Specialized profiles for SvelteKit, Next.js, React, Vue, Astro. AI-ready output that aligns with your stack.

28 Analyzers

Route detection, security analysis, dependency tracking, test coverage gaps. High-signal inputs for AI review.

Evidence-Based Signals

Every finding includes file paths, line numbers, and concrete evidence for AI and humans to cite. 

## Summary

This PR modifies 12 files across 3 categories.

### Route Changes
+ Added: /dashboard/settings
+ Added: /api/v2/users
- Removed: /api/legacy/auth

### Breaking Changes
! API endpoint removed: POST /api/legacy/auth
! Environment variable renamed: API_KEY -> AUTH_TOKEN

### Risk Assessment
Score: 67/100 (Medium)
Flags: breaking-api, env-change
{
  "highlights": [
    "Breaking API change: legacy auth endpoint removed",
    "New dashboard settings route added",
    "Environment variable migration required"
  ],
  "findings": [...],
  "riskScore": {
    "score": 67,
    "level": "medium",
    "flags": ["breaking-api", "env-change"]
  }
}
+------------------------------------------+
|           RISK REPORT                    |
+------------------------------------------+
| Score: 67/100                            |
| Level: MEDIUM                           |
+------------------------------------------+
| Flags:                                   |
|   - breaking-api (weight: 20)            |
|   - env-change (weight: 15)              |
|   - route-removal (weight: 10)           |
+------------------------------------------+
[about]

AI-ready tooling

Better Vibe builds developer tools that turn code changes into structured, high-signal context for AI workflows and teams. We prioritize accuracy over convenience, evidence over speculation, and privacy over cloud dependencies.

Our tools are fast, reliable, and transparent. Clear, verifiable analysis that AI agents can consume and developers can trust.

01 Local-first
02 Open source
03 Evidence-based
04 DX first
better tools. better vibes.

Get started

Install Branch Narrator and transform how AI-ready PR descriptions get written.

npx branch-narrator integrate
Star on GitHub Documentation