Track your work across Jira and Linear. Generate AI-powered summaries of your activities.
Project description
What Did I Do Again?
Track your work across Jira and Linear. Generate AI-powered summaries of your activities.
whatdidido is a command-line tool that syncs your work items from ticketing systems (Jira, Linear) and generates intelligent summaries using OpenAI. Perfect for status reports, performance reviews, and keeping track of what you've accomplished.
Features
- Multi-Platform Sync: Connect to Jira and Linear simultaneously
- AI-Powered Summaries: Generate narrative reports using OpenAI
- Secure: Credentials and all data stored on your computer
- Fast Setup: Interactive configuration wizard
- Flexible Reporting: Filter by date range, user, and more
- Team-Friendly: Track work for multiple team members
Installation
Install via pip:
pip install whatdidido
Requirements: Python 3.13 or higher
For detailed installation instructions, see INSTALL.md.
Quick Start
1. Configure Your Integrations
whatdidido connect
This interactive wizard will guide you through:
- Selecting which integrations to connect (Jira, Linear)
- Entering API credentials
- Configuring OpenAI for AI summaries (optional)
2. Sync Your Work
whatdidido sync
Fetches your work items from all configured integrations.
3. Generate a Report
whatdidido report
Creates an AI-powered summary of your activities in whatdidido.md.
Usage Examples
# Sync work from the last 30 days (Suppose today is 2025-10-23)
whatdidido sync --start-date 2025-09-23
# Sync work for a specific user
whatdidido sync --user colleague@company.com
# Sync a specific date range
whatdidido sync --start-date 2024-01-01 --end-date 2024-12-31
# View current configuration
whatdidido config
# Clean up synced data
whatdidido clean
Available Commands
| Command | Description |
|---|---|
connect |
Configure integrations and credentials |
sync |
Fetch work items from configured sources |
report |
Generate AI-powered summary report |
config |
Display current configuration |
disconnect |
Remove integration credentials |
clean |
Delete synced data files |
For comprehensive usage instructions, see USER_GUIDE.md.
Documentation
- Configuration Guide - How to obtain and configure API credentials
Supported Integrations
Data Sources (Ticketing Systems)
- Jira - Full support
- Linear - Full support
- PENDING GitHub - Planned for future release
Service Integrations
- OpenAI - For AI-powered report generation
- OpenRouter - Same as OpenAI, support for cha
Requirements
- Python 3.13 or higher
- API credentials for at least one data source (Jira or Linear)
- OpenAI API key (optional, required for
reportcommand)
Contributing
We welcome contributions! To contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run tests:
pytest - Format code:
black . - Submit a pull request
Development Setup
For local development:
git clone https://github.com/oliviersm199/whatdididoagain.git
cd whatdididoagain
pip install -e ".[dev]"
pre-commit install
Running Tests
pytest
pytest --cov=src # with coverage
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Roadmap
- GitHub integration support
- GitLab integration support
- Slack notifications
- Custom report templates
- Export to multiple formats (PDF, HTML)
- Team analytics and insights
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file whatdidido-0.1.3.tar.gz.
File metadata
- Download URL: whatdidido-0.1.3.tar.gz
- Upload date:
- Size: 50.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d111dd6598e6c8b31f156cfaea0f70981342837ff64c6bd74721e7589b5b2849
|
|
| MD5 |
3468475e24dab3476e379e204ee7e4df
|
|
| BLAKE2b-256 |
bbf507632313f28d4f612b48d4bda09f0b75cc5aa447a72f140955e06d1213ee
|
File details
Details for the file whatdidido-0.1.3-py3-none-any.whl.
File metadata
- Download URL: whatdidido-0.1.3-py3-none-any.whl
- Upload date:
- Size: 36.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bb48b229205687226824d4310a415148305a8ab8ad6c63525518982bf00c5874
|
|
| MD5 |
63e7af14214f7c499b5e5c7f9779003b
|
|
| BLAKE2b-256 |
055953b08969698219dd4ee6f4402677734761803f70e0bfa8b3af66e105bc8c
|