Skip to content

Tada v0.1.0 is here!!!

Choose a tag to compare

@ahmaruff ahmaruff released this 14 Sep 01:56
· 8 commits to main since this release

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 .md files 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 up
  • tada tidy - Consolidate task data with optional archiving (-a flag)

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

  1. Create an input.md file 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
  1. Run commands:
tada tidy        # Consolidate tasks
tada gen         # Generate report

Examples

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.