TaskForge is a DOCUMENT & FILE MANAGEMENT app for Markdown task files used with Obsidian.
Its core purpose is to LOCATE, READ, EDIT, and ORGANIZE Markdown (.md) task files across
user‑selected folders in shared storage (internal, SD card, or sync folders). To do this,
TaskForge requires Android’s special “All files access” (MANAGE_EXTERNAL_STORAGE). Without
this permission, the app cannot perform its core file‑management functions.

Built for Obsidian workflows
• Discover checkbox tasks across your vault’s Markdown files
• 100% Markdown: due/scheduled dates, priorities, tags, recurrence
• Works alongside Obsidian; not affiliated with or endorsed by Obsidian.md

What TaskForge does as a file manager
• Scans nested folders to find task‑containing Markdown files
• Reads & writes changes directly to the original .md files you selected
• Monitors files for changes made in other apps (like Obsidian) and updates views
• Supports large vaults and external storage/SD cards used by sync tools

Widgets & notifications (Android)
• Home Screen widgets for Today, Overdue, #tags, or any saved filter
• Due‑time notifications you can act on (Complete / Postpone)
• Works offline after initial vault selection; no account, no analytics

How it works
1) Choose your Obsidian vault folder on device (internal, SD card, or a sync folder)
2) TaskForge scans your Markdown files to discover tasks automatically
3) Manage tasks in the app and from widgets; changes write back to your files
4) Real‑time file monitoring keeps lists current when you edit files elsewhere

FILE SYSTEM REQUIREMENTS (Important)
TaskForge functions as a specialized FILE MANAGER for your Markdown task files. To keep your
mobile task system in sync with your vault, the app must:
• Read the contents of files in user‑selected folders (outside app storage)
• Efficiently process large, nested folders with many Markdown files to discover tasks
• Write updates back to the ORIGINAL files when you create, edit, or complete tasks
• Monitor files for real‑time changes so your task lists reflect the latest state

WHY “ALL FILES ACCESS” IS NEEDED
Obsidian vaults can live anywhere (internal storage, SD card, 3rd‑party sync roots). To
provide persistent, real‑time file management across these locations—without repeated
system pickers—TaskForge requests MANAGE_EXTERNAL_STORAGE and operates on the folder you
choose. We evaluated privacy‑friendly alternatives (Storage Access Framework / MediaStore),
but they do not support our core needs for vault‑wide indexing and low‑latency monitoring
across nested directories. We DO NOT upload or collect your files; data stays on device.

Privacy & compatibility
• No data collected; works offline after setup
• Works alongside your sync solution (Syncthing, FolderSync, Drive, Dropbox, etc.)
• Your files remain plain‑text Markdown and fully portable

Some advanced features may require TaskForge Pro.