Never forget why you made that decision.
Automatically track and document technical decisions by analyzing Git commits. Creates a searchable timeline of "why" behind your code.
2-minute demo: analyze, search, timeline, and export
git clone https://github.com/Artkill24/devmemory.git
cd devmemory
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# Analyze your repository
python src/cli.py analyze --days 30
python src/cli.py summary
β¨ Features
π Auto-detection - 11 decision types (dependencies, refactors, security fixes...)
πΎ Lightweight - SQLite database, no external services
π¨ Beautiful CLI - Rich terminal interface with colors and tables
π Analytics - Summary, timeline, and statistics
π Export - Generate Markdown documentation
π Search - Find decisions instantly
οΏ½οΏ½ Commands
CommandDescriptionanalyze --days NScan commits from last N dayslistShow all decisions in tablesummaryQuick project overview with metricstimelineVisual chronological view by monthsearch <keyword>Find specific decisionsshow <id>Full details of a decisionexportGenerate Markdown reportrecentToday's decisionsstatsStatistics by type
π Decision Types Detected
TypeKeywordsConfidenceπ¦ Dependency Addedadd, install, upgrade90%ποΈ Architecture Changerefactor, redesign, migrate80%π§ Workaroundhack, temporary, hotfix85%β‘ Performanceoptimize, cache, faster70%π Security Fixvulnerability, CVE95%βοΈ Config Changesettings, environment60%π API Designendpoint, route, interface75%ποΈ Database Schemamigration, table, column85%π Documentationdocs, readme40%π§ͺ Testingtest, unittest50%
π― Use Cases
Onboarding - New developers understand past decisions instantly
Documentation - Auto-generate decision logs and ADRs
Code Reviews - Provide context for why things exist
Technical Debt - Track workarounds and temporary solutions
Knowledge Transfer - Preserve team knowledge automatically
π Example Output
DevMemory Decisions (2 shown)
ββββββββββββ³βββββββββββββββββββββ³βββββββββββ³βββββββββββββ³βββββββββ
β Date β Type β Author β Title β Hash β
β‘βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ©
β 2025-10 β Architecture Changeβ Dev β Switch JWT β 6387e8 β
β 2025-10 β Dependency Added β Dev β Add Redis β 2def04 β
ββββββββββββ΄βββββββββββββββββββββ΄βββββββββββ΄βββββββββββββ΄βββββββββ
π€ Contributing
Contributions welcome! See CONTRIBUTING.md
Ideas for contributions:
New decision patterns
Export formats (PDF, JSON)
Web interface
GitHub Actions integration
More tests
π License
MIT License - See LICENSE
π Acknowledgments
Created as an experiment in solving real developer pain points using AI-assisted development.
β Star this repo if DevMemory saved you from asking "why did we do this?"