status.md — Get context on your last coding session with…

Pitch

Description

Comments

About this project

status.md is a CLI tool that leverages AI to summarize your recent project activities using git diffs. Perfect for developers returning after a break, it provides a quick overview of what was accomplished, enabling seamless re-engagement with your code. With features like file change tracking and multiple AI provider options, it enhances workflow efficiency.

status.md is a powerful CLI tool designed to enhance productivity for developers by providing a concise summary of recent local project activities. Utilizing artificial intelligence, it analyzes git diffs to generate structured insights about the last work sessions, making it easier for developers to pick up where they left off after extended breaks from their projects.

Key Features

TL;DR Summaries: Quickly grasp what has changed in the project at a glance.
File-wise Change Tracking: Monitor modifications with precise timestamps for better context.
AI-driven Summaries: Automated extraction of TODO and FIXME comments alongside change descriptions.
Support for Git: Works seamlessly with both staged and unstaged diffs.
Versatile AI Options: Choose from multiple AI providers, including Gemini and Phind.
Flexible Output Formats: View output in easy-to-read Markdown or use a colorized terminal view for immediate feedback.

Efficient Usage

To engage status.md, the command is:

statusmd update

Developers can select their preferred AI provider using the following syntax:

--provider=gemini       # or phind (default)

Ensure to configure the necessary environment variables for AI provider usage.

Output Example

The output from status.md enhances clarity with structured details:\n

TL;DR
Refactored project structure to include more source files in CMake, integrated sdbus-c++ for MPRIS, and began implementing LastFM support.

Changes (2025-04-28)
- `src/lastfm.hpp`: modified (2025-04-28) - Renamed and refactored LastFM class to manage LastFM API calls.
- `src/main.cpp`: modified (2025-04-28) - Updated includes to use header files only, initialized and ran MPRIS interface in a separate thread.

TODOs
- No TODOs/FIXMEs found.

How It Functions

Collects recent uncommitted changes along with the last 2-3 commit messages.
Extracts any TODO or FIXME tags from code diffs.
Constructs an informative prompt using file changes, statuses, and timestamps.
Sends this contextual information to a designated AI provider.
Processes and formats the structured AI response into Markdown or terminal display, ensuring accessibility for developers.

By integrating status.md into the workflow, developers can transition back into their coding tasks effortlessly, maintaining focus and increasing efficiency in their development endeavors.