Daily Work Report
A VS Code extension that automatically generates a daily work report from today's Git commits in your open workspace.
Features
- Generate Daily Report — creates an English Markdown report from today's commits
- Generate AI Daily Report — transforms commits into a professional Arabic report using Google Gemini (no setup required)
- Collects all Git commits from today (since local midnight)
- Saves reports automatically in your workspace root
- Handles missing workspace, non-Git folders, and errors gracefully
Example Output (English)
# Daily Report
## Completed Tasks
- Fix cart dollar total calculation
- Improve mobile performance
## Statistics
- Total Commits: 2
Reports are saved as DAILY_REPORT_YYYY-MM-DD.md in the workspace root.
Example Output (AI Arabic)
# التقرير اليومي
## المهام المنجزة
- تحسين آلية حساب إجماليات السلة وتصحيح الأخطاء المرتبطة بالعملة.
- معالجة مشكلات التحقق أثناء إتمام عملية الشراء.
AI reports are saved as AI_DAILY_REPORT_YYYY-MM-DD.md in the workspace root.
Prerequisites
- Node.js 18 or later
- Git installed and available on your PATH
- VS Code 1.85 or later
- Internet connection (for AI reports only)
AI Arabic Report
Run Daily Report: Generate AI Daily Report from the Command Palette. No API key or configuration is required — the extension includes built-in Gemini integration.
If your preferred model is unavailable or quota-exhausted, the extension automatically tries other Gemini models in order until one succeeds.
Privacy
When you generate an AI report, only today's Git commit subject lines are sent to Google's Gemini API. No repository names, file paths, or author information are included.
Installation (Development)
Clone or open this project in VS Code.
Install dependencies:
npm install
Compile TypeScript:
npm run compile
Debug (F5)
- Open this folder in VS Code.
- Press F5 to launch the Extension Development Host.
- In the new window, open a folder that contains a Git repository.
- Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P).
- Run Daily Report: Generate Daily Report or Daily Report: Generate AI Daily Report.
Package (VSIX)
Create a VSIX package for manual installation:
npm run package
This produces daily-work-report-0.2.0.vsix in the project root.
Manual Installation (VSIX)
- In VS Code, open the Extensions view (
Ctrl+Shift+X / Cmd+Shift+X).
- Click the ... menu and choose Install from VSIX...
- Select the generated
.vsix file.
- Reload VS Code if prompted.
Usage
English Report
- Open a workspace folder that is a Git repository.
- Make commits during the day as usual.
- Run Daily Report: Generate Daily Report from the Command Palette.
- Find the report at
DAILY_REPORT_YYYY-MM-DD.md in your workspace root.
AI Arabic Report
- Open a workspace folder that is a Git repository with commits from today.
- Run Daily Report: Generate AI Daily Report from the Command Palette.
- Find the report at
AI_DAILY_REPORT_YYYY-MM-DD.md in your workspace root.
If there are no commits today, you will see an informational message and no file is created.
Settings
| Setting |
Default |
Description |
daily-report.geminiModel |
gemini-2.5-flash |
Preferred Gemini model (tried first; automatic fallback on 429/503/404) |
Troubleshooting
| Issue |
Solution |
| "Open a folder in VS Code..." |
Use File → Open Folder before running the command. |
| "This folder is not a Git repository." |
Run git init in the folder or open a Git-backed project. |
| "Git is not installed..." |
Install Git and ensure git is on your PATH. |
| "Unable to generate AI report..." |
Check network connection; open Daily Report output channel for details. |
| "Unable to read Git history..." |
Open View → Output, select Daily Report, and review the log. |
| "Unable to save the report..." |
Check that the workspace folder is writable. |
Known Limitations
- Uses the active editor's workspace folder, or the first workspace folder in multi-root setups.
- Includes all commits from today on the current branch (no author filter).
- Regenerating a report on the same day overwrites the existing file.
- "Today" is defined by Git's
--since=midnight in your local timezone.
- AI reports require an internet connection.
- Only Google Gemini is supported in v2.
Project Structure
src/
├── extension.ts # Extension entry point
├── commands/ # Command handlers
├── services/ # Report generation logic
├── ai/ # Gemini client and prompts
│ └── prompts/ # Editable AI prompt templates
├── config/ # Gemini configuration (API key)
├── git/ # Git CLI integration
├── utils/ # Shared utilities
└── types/ # TypeScript interfaces
License
MIT