Repository navigation
Tada v0.1.0 is here!!!
v0.1.0 - Initial Release
What's New
Tada v0.1.0 is the first release of the markdown-based task management tool. Work with plain markdown files using any editor and let Tada handle task consolidation and report generation.
Features
Core Functionality
- Markdown-native task management - Work with
.mdfiles in any editor - Smart task consolidation - Automatically merge task data across Backlog, Todo, Done sections
- ID-based task linking - Track tasks across sections using unique IDs
- Date-range reports - Generate clean reports with automatic filename dating
- Flexible archiving - Optional moving of completed tasks for reporting
Commands
tada gen- Complete workflow: consolidate → archive → generate report → clean uptada tidy- Consolidate task data with optional archiving (-aflag)
File Format Support
- Four-section structure: Backlog, Todo, Done, Archives
- Task statuses:
[ ]todo,[x]done,[-]in progress - Rich task data: Projects (
@project), IDs (#123), date ranges - Subtasks and descriptions - Full markdown support
- Date headers - Organize Todo/Done by dates
CLI Features
- Dry run mode - Preview changes with
--dry-run - Verbose output - Detailed logging with
-v - Flexible input/output - Custom file paths and output directories
- Smart date detection - Automatic report filename generation
Installation
Download the binary for your platform from the [releases page](https://github.com/ahmaruff/tada/releases).
Quick Start
- Create an
input.mdfile with your tasks:
## Backlog
- [ ] Task 1 <!-- @project|#1 -->
- [x] Task 2 <!-- @project|#2|2025-01-15 -->
## Todo
### 2025-01-16 - Wednesday
- [ ] Daily work <!-- @project|#3 -->
## Done
### 2025-01-15 - Tuesday
- [x] Completed work <!-- @project|#4 -->
## Archives- Run commands:
tada tidy # Consolidate tasks
tada gen # Generate reportExamples
Check the example/ folder for sample files showing the complete workflow.
What's Next
Future releases will focus on:
- Enhanced date handling and time tracking
- More report formats and customization
- Integration with popular editors and tools
- Performance improvements for large task files
Known Issues
- Tasks without IDs cannot be automatically consolidated across sections
- Date parsing is strict and requires YYYY-MM-DD format
Contributing
Contributions welcome! Check the repository for guidelines and open issues.