Local-First GTD on Arch Linux & Android
Philosophy
Mindwtr is built to be simple by default and powerful when you need it. We focus on reducing cognitive load, cutting the fat, and keeping you in flow. That means:
- Progressive disclosure: advanced options stay hidden until they matter.
- Less by default: fewer fields, fewer knobs, fewer distractions.
- Avoid feature creep: we prioritize clarity over clutter.
Don't show me a cockpit when I just want to ride a bike.
Features
GTD Workflow
- Capture - Quick add tasks from anywhere (global hotkey, tray, share sheet, voice)
- Clarify - Guided inbox processing with 2-minute rule
- Organize - Projects, contexts, and status lists
- Reflect - Weekly review wizard with reminders
- Engage - Context-filtered next actions
- AI Assist (Optional) - Clarify, break down, and review with BYOK AI (OpenAI, Gemini, Claude)
Views
- π₯ Inbox - Capture zone with processing wizard
- π― Focus - Agenda (time-based) + Next Actions in one view
- π Projects - Multi-step outcomes with areas
- π·οΈ Contexts - Hierarchical contexts (@work/meetings)
- β³ Waiting For - Delegated items
- π Someday/Maybe - Deferred ideas
- π
Calendar - Time-based planning
- π Board - Kanban-style drag-and-drop
- π Review - Daily + weekly review workflows
- π¦ Archived - Hidden history, searchable when needed
Productivity Features
- π Global Search - Search operators (status:, context:, due:<=7d)
- π¦ Bulk Actions - Multi-select, batch move/tag/delete
- π Task Dependencies - Block tasks until prerequisites complete
- π Attachments - Files and links on tasks
- βοΈ Markdown Notes - Rich text descriptions with preview
- ποΈ Project States - Active, Waiting, Someday, Archived
- βΎοΈ Fluid Recurrence - Strict dates or βX days after completionβ
- β»οΈ Reusable Lists - Duplicate tasks or reset checklists
- β
Checklist Mode - Fast list-style checking for checklist tasks
- β
Audio Capture - Quick voice capture with automatic transcription and task creation
- π§ Copilot Suggestions - Optional context/tag/time hints while typing
- π§ Focus / Zen Modes - Reduce clutter and highlight top priorities
- π Notifications - Due date reminders with snooze
- π Daily Digest - Morning briefing + evening review
- π
Weekly Review - Customizable weekly reminder
Data & Sync
- π File Sync - Dropbox, Google Drive, Syncthing, etc.
- π WebDAV Sync - Nextcloud, ownCloud, self-hosted
- π Smart Merge - Last-write-wins prevents data loss
- π€ Export/Backup - Export data to JSON
- ποΈ External Calendars (ICS) - View-only calendar overlay
Automation
- π CLI - Add, list, complete, search from terminal
- π REST API - Local API server for scripting
- π Web App (PWA) - Browser access with offline support
- π§ MCP Server - Local Model Context Protocol server for LLM automation
Cross-Platform
- π₯οΈ Desktop - Tauri v2 (macOS, Linux, Windows)
- π± Mobile - React Native/Expo (
iOS, Android)
- π² Android Widget - Home screen focus/next widget
- β¨οΈ Keyboard Shortcuts - Vim and Emacs presets
- π¨ Themes - Light/Dark
- π i18n - English, Chinese, Spanish, Hindi, Arabic, German, Russian, Japanese, French, Portuguese, Korean, Italian, Turkish
- π³ Docker - Run the PWA + self-hosted sync server with Docker
Platform Notes
- Desktop: Global shortcuts, keyboard navigation, no swipe actions, no zen mode.
- Mobile: Swipe actions, zen mode, Android widget support; no global shortcuts.
Installation
Desktop (Linux)
Arch Linux (AUR):
# Using yay
yay -S mindwtr-bin
# Using paru
paru -S mindwtr-bin
π¦ AUR Package
Debian/Ubuntu:
Download the .deb from GitHub Releases and install:
sudo dpkg -i mindwtr_*.deb
AppImage (Universal):
Download the .AppImage from GitHub Releases:
chmod +x Mindwtr_*.AppImage
./Mindwtr_*.AppImage
Fedora/RHEL/openSUSE:
Download the .rpm from GitHub Releases and install:
sudo rpm -i mindwtr-*.rpm
Desktop (Windows)
Winget (recommended):
winget install dongdongbh.Mindwtr
Alternative: Scoop
scoop bucket add mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr
Installer:
Download the installer (.msi or .exe) from GitHub Releases and run it.
Desktop (macOS)
Homebrew (recommended):
brew tap dongdongbh/mindwtr
brew install --cask mindwtr
DMG:
Download the disk image (.dmg) from GitHub Releases, open it, and drag the application to your Applications folder.
> Note: If macOS says the app is "damaged" or from an "unidentified developer", run:
> bash > xattr -cr /Applications/Mindwtr.app >
> Then open the app normally. This is required because the app is not notarized with Apple.
Mobile
Android:
Download the APK from GitHub Releases.
For those asking about the Android version, I have opened up the Closed Testing track on the Google Play Store.
To get access, you need to be "whitelisted" by Google. I set up a Google Group to automate this process, so I don't need to add everyone's email address manually one by one.
How to join:
iOS:
iOS builds require an Apple Developer account ($99/year). Currently available as simulator builds only. If you want iOS builds, please consider sponsoring the developer so we can fund the Apple Developer account.
Docker (PWA + Cloud Sync)
Run the web app (PWA) and the self-hosted sync server with Docker:
Data Storage
Tasks and projects are stored locally on your device:
- Desktop data (Linux):
~/.local/share/mindwtr/mindwtr.db (SQLite) + data.json (sync/backup)
- Desktop config (Linux):
~/.config/mindwtr/config.toml
- Mobile:
mindwtr.db (SQLite) + data.json (sync/backup)
Sync via File (Dropbox, etc.) or WebDAV (Nextcloud, etc.) can be configured in Settings.
Documentation
Roadmap
- β
Build an MCP server for Mindwtr (LLM integration and automation).
- β³ Add email capture (forward emails to create tasks).
Development
For developers, see the Development Guide.
