Skip to content

LakshmiPrakash-codes/devlog-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 

Repository files navigation

DevLog CLI πŸ—‚οΈ

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.


Features

  • 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

Demo

$ 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.

Tech Stack

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

Project Structure

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

Installation

git clone https://github.com/LakshmiPrakash-codes/devlog-cli
cd devlog-cli
pip install -e .

Commands

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>

Why I Built This

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.


Status

πŸ”¨ Actively building β€” follow for updates.


Author

Lakshmi Prakash Nagati LinkedIn Β· GitHub Β· nlp.jobmail@gmail.com

About

Developer daily activity logger with streaks & reports | Python, PostgreSQL, Click

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors