A local-first, single-file web application, Markdown Task Manager transforms Markdown files into an interactive Kanban board without requiring databases or servers. It targets developers and distributed teams seeking a Git-compatible, privacy-focused task management solution, offering seamless integration with AI assistants for automated workflow management.

How It Works

The application is a self-contained HTML file that leverages the browser's File System Access API to directly read and write task data to local Markdown files (kanban.md, archive.md). This approach eliminates the need for databases or servers, ensuring data remains entirely on the user's machine and is easily versionable with Git.

Quick Start & Requirements

Installation involves downloading the task-manager.html file and opening it in a compatible browser (Chrome 86+, Edge 86+, Opera 72+). The File System Access API is a core requirement, meaning it is not supported on Firefox or Safari. Upon first launch, the user selects a folder to store their task Markdown files, which the application then creates if empty.

Highlighted Details

• AI Integration: Designed for deep integration with AI assistants (e.g., Claude, ChatGPT, Copilot, Gemini) to automate task creation, updates, and documentation directly within Markdown files.
• Git Compatibility: Storing tasks in plain Markdown files makes them inherently Git-friendly, enabling version control, team synchronization, and diffing.
• Local-First & Privacy: Operates entirely offline with no data sent over the internet, no tracking, and no account required, ensuring maximum data privacy and control.
• Single-File Architecture: The entire application is delivered as a single HTML file, simplifying distribution, maintenance, and deployment.

Maintenance & Community

The project provides a clear roadmap for future development, including features like dark mode, keyboard shortcuts, and advanced synchronization. Support and bug reporting are primarily handled through GitHub issues. No specific community channels like Discord or Slack are mentioned.

Licensing & Compatibility

The project is distributed under the Mozilla Public License 2.0 (MPL-2.0). This license permits use in commercial and private projects but requires that any modifications to the source files be distributed under the same MPL-2.0 license, with copyright notices preserved.

Limitations & Caveats

Support is limited to specific browsers (Chrome, Edge, Opera) due to the reliance on the File System Access API, excluding Firefox and Safari. Mobile browser support is also noted as limited. Full offline capabilities via Service Worker and cross-device synchronization are planned for future versions.