A developer's personal activity logger β track what you build, spot your patterns, own your progress.
Most developers forget what they worked on last week. DevLog fixes that. It's a lightweight CLI tool that lets you log your daily development activity, tag it by project, and get insightful weekly/monthly summaries β with streaks, productivity scores, and markdown exports.
Built for developers who want a private, terminal-native alternative to scattered notes.
- Log entries with a single command β what you did, which project, what type of work
- Streak tracking β consecutive active days, longest streak, current streak
- Weekly & monthly reports β activity breakdown by project and work type
- Smart insights β detects patterns like "You've been mostly debugging this week"
- Export to Markdown β generate a clean report you can paste anywhere
- Fully offline β your data stays on your machine
$ devlog add "Built authentication module with JWT" --project openstatus --type feature
β
Logged entry #42 | project: openstatus | type: feature
$ devlog summary --week
π Weekly Summary (May 6 β May 12)
ββββββββββββββββββββββββββββββββββ
Total entries : 14
Active days : 6 π₯ (streak: 6 days)
Top project : openstatus (8 entries)
Work breakdown : feature 57% | bugfix 28% | learning 15%
π‘ Insight: Heavy feature work this week. Consider writing tests next.| Layer | Technology |
|---|---|
| Language | Python 3.11+ |
| CLI Framework | Click |
| Database | SQLite (local) / PostgreSQL (optional) |
| OOP Design | Transaction, Project, Report, Streak classes |
| Testing | pytest |
| Packaging | pip / setup.py |
devlog-cli/
βββ devlog/
β βββ __init__.py
β βββ cli.py # Click command definitions
β βββ models.py # OOP β Entry, Project, Report classes
β βββ database.py # DB connection and queries
β βββ analytics.py # Streak logic, insights engine
β βββ exporter.py # Markdown export
βββ tests/
βββ README.md
βββ requirements.txt
βββ setup.py
git clone https://github.com/LakshmiPrakash-codes/devlog-cli
cd devlog-cli
pip install -e .devlog add "entry text" --project <name> --type <feature|bugfix|learning|review>
devlog summary --week
devlog summary --month
devlog streak
devlog export --format markdown
devlog list --project <name>I started this as my first real Python project β something I'd actually use every day. It forced me to apply OOP properly, design a real database schema, think about user experience in a terminal, and write clean, testable code. Every feature in here is something I genuinely wanted.
π¨ Actively building β follow for updates.
Lakshmi Prakash Nagati LinkedIn Β· GitHub Β· nlp.jobmail@gmail.com