Tasks Cleaner Plugin is a powerful tool designed for Obsidian users who want to maintain tidy Markdown notes by automatically removing old completed tasks. This plugin is especially beneficial for individuals tracking tasks with completion dates, ensuring that notes remain organized and clutter-free.

Key Features

• Customizable Task Detection: Utilize a tailor-made regular expression to identify completed tasks in your notes.
• Automatic Cleanup: Configure the plugin to delete tasks that are older than a defined number of days.
• Description Removal: The plugin not only deletes the task but also removes any associated descriptions found beneath it.
• File Filtering: Specify which files to scan for task cleanup based on filename patterns.
• User Confirmation: Before any deletions are made, a confirmation modal provides a summary of tasks scheduled for removal.
• Configurability: The plugin settings allow for complete customization based on individual preferences.

Installation Guide

To set up Tasks Cleaner, search for "Tasks Cleaner" in the Obsidian community plugins browser. After enabling the plugin in the settings, configure it to meet your organizational needs.

Configuration Options

Access the plugin settings through Settings → Community Plugins → Tasks Cleaner. Key options include:

• Delete tasks older than (days): Set the age threshold in days for task deletion (default is 7 days).
• Task pattern (Regex): Input a regular expression for detecting completed tasks (default example: - \[x\].*?✅\s*(\d{4}-\d{2}-\d{2})).
• Filename filter: Specify a string to filter which files to scan, or leave it empty to include all Markdown files.

Task Format

The plugin looks for completed tasks formatted as follows:

-   [x] Fixed the bug ✅ 2024-12-01
        This issue only appears in Firefox
        Additional explanation

If a task's completion date exceeds the specified threshold, it, along with any indented descriptions, will be removed following user confirmation.

Example

Consider the following Markdown file TODO Project.md:

-   [x] Fix bug ✅ 2024-12-01
        This happens in Firefox
-   [ ] Implement feature

With a threshold of 7 days, the first task and its description will be deleted after confirmation, keeping notes clean and relevant.

Safe Deletion Process

Prior to any deletion, a confirmation modal will appear to inform users of the number of tasks due to be removed from each file, ensuring that no data is lost without consent.

With Tasks Cleaner, keep your notes clear and focused, enabling better task management within your Obsidian environment.