Skip to content

anshrjpt/DEV-LOG

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

116 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Language Frontend License Status FOSS


A C++ command-line journal for developers that tracks daily coding sessions and auto-generates beautiful HTML progress reports.



Overview

Most developers forget what they built two weeks ago. DevLog fixes that by giving you a simple terminal prompt each day — what you worked on, what you learned, what blocked you — and turning all of it into a self-contained HTML report you can share or keep for yourself.

No external libraries. No internet required. Just C++17 and a browser.


Getting Started

Requirements: g++ with C++17 support (standard on Linux and macOS)

git clone https://github.com/anshrjpt/DEV-LOG.git
cd DEV-LOG
make
./devlog

Commands

  ██████╗ ███████╗██╗   ██╗██╗      ██████╗  ██████╗
  ██╔══██╗██╔════╝██║   ██║██║     ██╔═══██╗██╔════╝
  ██║  ██║█████╗  ██║   ██║██║     ██║   ██║██║  ███╗
  ██║  ██║██╔══╝  ╚██╗ ██╔╝██║     ██║   ██║██║   ██║
  ██████╔╝███████╗ ╚████╔╝ ███████╗╚██████╔╝╚██████╔╝

  Developer Journal · v1.0 · FOSS
Command Description
./devlog new Log today's dev session
./devlog list View all past entries
./devlog read <date> Read entry by date (YYYY-MM-DD)
./devlog search <keyword> Search entries by keyword
./devlog stats Show coding stats dashboard
./devlog report Generate a full HTML report
./devlog week Show this week's summary
./devlog edit Edit the last entry
./devlog help Show all commands

How It Works

┌──────────────────────────────────────────────────────────────────┐
│                                                                  │
│   You answer 5        C++ saves each       C++ reads all logs    │
│   prompts in    →     entry as JSON    →   and computes stats    │
│   the terminal        to /logs/                  |               │
│                                                  v               │
│                       A self-contained HTML report is generated  │
│                       and saved to /reports/                     │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

Each daily entry stores: what you worked on, what you learned, what blocked you, tags, and a mood score (1-5).

The generated HTML report includes a stats bar, entry timeline, activity heatmap, top topics, skill breakdown, and mood chart — all in a single file with no external dependencies.


Project Structure

dev-journal/
├── src/
│   └── main.cpp          ← entry point and command router
├── logs/                 ← daily entries stored as JSON
├── reports/              ← generated HTML reports
├── Makefile
└── README.md

Build Log

This project is being built live at 1 hour per day as part of a FOSS hackathon.

Phase Days Status
Foundation & Setup Days 1-5 Complete
Core C++ Logic Days 6-12 complete
HTML Report Generator Days 13-19 In progress
Extra Features Days 20-22 Upcoming
Polish & Submit Days 23-25 Upcoming

Contributing

Contributions, issues, and feature requests are welcome.

git checkout -b feature/your-feature-name
git commit -m "feat: describe your change"
git push origin feature/your-feature-name

Open a Pull Request with a clear description of what you changed and why.


Contributors

Ansh
Ansh Rajpoot

Core Developer
Mishika
Mishika Agarwal

Core Developer

License

MIT License — free to use, modify, and distribute. See LICENSE for details.


Built for the FOSS community · If this helped you, consider giving it a star.

About

A C++ command-line journal for developers that tracks daily coding sessions and auto-generates beautiful HTML progress reports.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors