IntentLedger

The living book of intentions for AI-generated code

IntentLedger automatically extracts, stores and keeps alive the why behind every decision in your codebase even when the code is generated by Cursor, Claude, Grok or any other AI.

Stop losing understanding of your own project. Never again ask “why did I write this like this?”.

Requirements

• Node.js >= 20
• Python 3.12+
• Ollama (required)

Features

• ledger --version — Show current version
• ledger init — Initialize the living ledger in any repository
• ledger scan — Parse changed files with Tree-sitter and store basic intent
• ledger list — Show all saved intentions
• ledger ask "your question" — Ask anything about the codebase
• Automatic git post-commit hook
• Local-first (SQLite + Ollama ready)
• Supports JavaScript, Python (more languages coming)

Quick Start

# 1. Install
npm install --legacy-peer-deps
npm link

# 2. Initialize in your project
ledger init

# 3. Scan and start using
ledger scan
ledger list
ledger ask "What does the main function do?"