Mindwtr

English | 中文

A complete Getting Things Done (GTD) productivity system for desktop and mobile. Mind Like Water.

New to GTD? Read GTD in 15 minutes for a quick introduction.

desktop-e.mp4

mobile-e.mp4

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:

xattr -cr /Applications/Mindwtr.app

Then open the app normally. This is required because the app is not notarized with Apple.

Mobile

Android:

Mindwtr is available on Google Play: https://play.google.com/store/apps/details?id=tech.dongdongbh.mindwtr

Download the APK from GitHub Releases.

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:

• Guide: docker/README.md

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

• 📚 Wiki - Complete user guide
• 🚀 Getting Started
• 💡 GTD Best Practices
• 🤖 AI Assistant
• 🗓️ Calendar Integration
• ☁️ Cloud Sync (Self‑Hosted)
• 🔌 Local API Server
• 🌐 Web / PWA

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.