DevLog-Agent

Automated developer logging powered by AI — Intelligently capture your daily work, transform emails into actionable summaries, and maintain a living project history with zero manual effort.

Overview

DevLog-Agent is an intelligent automation tool that bridges your email inbox with your development workflow. It reads your emails from the last 24 hours, intelligently summarizes work and important tasks using Google's Gemini AI, and automatically commits these insights to your GitHub repository's dev log.

Perfect for maintaining project history, tracking progress, and keeping your team in sync—without the manual overhead.

✨ Features

• 📧 Email Integration — Automatically reads emails from the last 24 hours via Gmail API
• 🧠 AI-Powered Summarization — Uses Google Gemini 3.5 Flash to intelligently extract and summarize work tasks
• 🚀 GitHub Auto-Update — Automatically commits clean, formatted summaries to your devlog.md
• ⚡ Zero Configuration Needed — OAuth2 authentication handles itself with secure token storage
• 🔄 Scheduled Automation Ready — Easy to integrate with cron jobs or task schedulers

🛠️ Tech Stack

• LangChain — AI agent orchestration and tool integration
• Google Gemini API — Intelligent text summarization
• PyGithub — GitHub repository management
• Gmail API — Email retrieval and processing
• Python 3.8+ — Core language

📋 Requirements

Before getting started, ensure you have:

• Python 3.8 or higher
• A Google account with Gmail enabled
• A GitHub account with a repository containing devlog.md
• API keys for:
  • Google API (Gemini)
  • GitHub Personal Access Token

🚀 Quick Start

1. Clone and Setup

git clone <your-repo-url>
cd DevLog-Agent
pip install -r requirements.txt

2. Configure API Credentials

Create a .env file in the project root:

GOOGLE_API_KEY=your_google_api_key_here
GITHUB_TOKEN=your_github_token_here
GITHUB_REPO=username/repo-name

3. Set Up Gmail OAuth

1. Download your Google OAuth credentials as credentials.json from Google Cloud Console
2. Place it in the project root
3. The app will handle OAuth setup on first run

4. Run the Agent

python Agent.py

The agent will:

1. ✅ Read your last 24 hours of emails
2. ✅ Summarize work and important tasks
3. ✅ Update your devlog.md with a clean bullet-point summary
4. ✅ Commit the changes to GitHub

📁 Project Structure

DevLog-Agent/
├── Agent.py                 # Main agent orchestration
├── credentials.json         # Gmail OAuth credentials (git-ignored)
├── token.json              # Gmail OAuth token (git-ignored)
├── requirements.txt        # Python dependencies
├── .env                    # Environment variables (git-ignored)
└── tools/
    ├── __init__.py
    ├── gmail.py            # Gmail API integration
    └── github_tool.py      # GitHub repository updates

🔧 How It Works

1. Email Reading (tools/gmail.py)

   • Connects to Gmail API with OAuth2
   • Retrieves all emails from the last 24 hours
   • Extracts sender, subject, and content

2. AI Summarization (Agent.py)

   • Uses LangChain to create an agent with available tools
   • Feeds emails to Google Gemini for intelligent summarization
   • Focuses on work tasks and important items

3. GitHub Update (tools/github_tool.py)

   • Fetches your devlog.md from the target repository
   • Prepends today's date and AI-generated summary
   • Commits changes back to GitHub with a timestamped message

📝 Example Dev Log Output

# Dev Log

## 26 May 2026
- Completed sprint planning for Q2 release
- Fixed critical authentication bug in login flow
- Reviewed PR for new payment module
- Meeting scheduled with design team for UI refresh

## 25 May 2026
- Deployed hotfix to production
- Updated API documentation

🔐 Security Considerations

• Never commit credentials.json, token.json, or .env files
• Use GitHub Personal Access Tokens instead of passwords
• Limit token permissions to only necessary scopes (repo read/write)
• Rotate tokens periodically for security best practices

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests for:

• New tool integrations (Slack, Discord, etc.)
• Enhanced summarization capabilities
• Better error handling and logging
• Performance improvements

📄 License

This project is licensed under the MIT License—feel free to use and modify as needed.

🎯 Future Enhancements

• Support for additional email providers
• Custom summarization templates
• Integration with Slack for notifications
• Weekly/monthly digest generation
• Scheduled execution with cron/APScheduler
• Multi-language support
• Sentiment analysis and task prioritization

📞 Support

Have questions or issues?

• Check the troubleshooting guide (coming soon)
• Open an issue on GitHub
• Review API documentation for Gmail and GitHub

---

Made with ❤️ to automate your workflow and keep your dev log fresh.