# Mindwtr English | [中文](./README_zh.md) A complete Getting Things Done (GTD) productivity system for desktop and mobile. *Mind Like Water.* *New to GTD? Read [GTD in 15 minutes](https://hamberg.no/gtd) for a quick introduction.* [](https://github.com/dongdongbh/Mindwtr/actions/workflows/ci.yml) [](LICENSE) [](https://github.com/dongdongbh/Mindwtr/releases) [](https://deepwiki.com/dongdongbh/Mindwtr) [](https://discord.gg/ahhFxuDBb4) [](https://github.com/sponsors/dongdongbh) [](https://ko-fi.com/D1D01T20WK)

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
• 📎 Attachments - Files and links on tasks
• ✏️ Markdown Notes - Rich text descriptions with preview
• 🗂️ Project States - Active, Waiting, Someday, Archived
• ♾️ Fluid Recurrence - Next date is calculated 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
• 🍅 Pomodoro Focus (Optional) - 15/3, 25/5, 50/10 timer panel in Focus view
• 🔔 Notifications - Due date reminders with snooze
• 📊 Daily Digest - Morning briefing + evening review
• 📅 Weekly Review - Customizable weekly reminder

Data & Sync

• 🔄 Sync Options - See the Data & Sync wiki for supported backends and setup
• 📤 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 via App Store/TestFlight, 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

Requirements

End Users

• Desktop builds from package managers/app stores do not require Bun or Node.js.
• Mobile users can install from App Store / Google Play directly.

Building From Source

• Bun: >= 1.1 (workspace install, scripts, tests)
• Node.js: >= 18 (recommended for tooling compatibility)
• Rust toolchain + platform WebView dependencies (for Tauri desktop builds)
• Android Studio/SDK and/or Xcode (for React Native mobile builds)

Installation

Desktop (Linux)

Arch Linux (AUR):

# Using yay
yay -S mindwtr-bin

# Using paru
paru -S mindwtr-bin

Debian / Ubuntu (APT repo, recommended):

curl -fsSL https://dongdongbh.github.io/Mindwtr/mindwtr.gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/mindwtr-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mindwtr-archive-keyring.gpg] https://dongdongbh.github.io/Mindwtr/deb ./" | sudo tee /etc/apt/sources.list.d/mindwtr.list
sudo apt update
sudo apt install mindwtr

Fedora / RHEL / openSUSE (DNF/YUM repo, recommended):

cat <<'EOF' | sudo tee /etc/yum.repos.d/mindwtr.repo
[mindwtr]
name=Mindwtr Repository
baseurl=https://dongdongbh.github.io/Mindwtr/rpm
enabled=1
gpgcheck=0
EOF

sudo dnf install mindwtr

Snapcraft:

sudo snap install mindwtr

Other methods: AppImage or .deb/.rpm from GitHub Releases.

Desktop (Windows)

Microsoft Store (recommended):

Winget:

winget install dongdongbh.Mindwtr

Scoop:

scoop bucket add mindwtr https://github.com/dongdongbh/homebrew-mindwtr
scoop install mindwtr

Other methods: .msi / .exe from GitHub Releases.

Desktop (macOS)

Mac App Store (recommended):

Install from the Mac App Store: Mindwtr on Mac App Store.
TestFlight beta (macOS): Join the beta.

Homebrew:

brew install --cask mindwtr

Other methods: .dmg from GitHub Releases.

Mobile

Android:

Install with IzzyOnDroid:

1. Install an F-Droid-compatible client (Droid-ify, Neo Store, or F-Droid).
2. Add the IzzyOnDroid repository: https://apt.izzysoft.de/fdroid/repo.
3. Open Mindwtr on IzzyOnDroid and install.

Other methods: APK from GitHub Releases.

iOS:

Available on the App Store: Mindwtr for iOS.
TestFlight beta: Join the beta.

However, maintaining the iOS version on the App Store requires a substantial annual fee (see the Apple Developer Program), which I currently cover out of pocket.

To ensure Mindwtr's continued existence and future development, your support is greatly appreciated! If you find value in the app, please consider supporting the project via GitHub Sponsors or Ko-fi.

Docker (PWA + Cloud Sync)

Run the web app (PWA) and the self-hosted sync server with Docker:

• Guide: docker/README.md

Install guides:

• 🚀 Getting Started
• 📚 All platforms & package managers

Community

Mindwtr is shaped by its users and contributors. Thank you for helping improve it.

♥️ Contributing & Support

If you want to get involved, start with CONTRIBUTING.md.

You can help in several ways:

1. Spread the word: Share Mindwtr with friends and communities, and support it on Product Hunt and AlternativeTo.
2. Leave store reviews: A good rating/review on the App Store, Google Play, or Microsoft Store helps a lot.
3. Star and share: Star the repo and post about Mindwtr on X, Reddit, or LinkedIn.
4. Report bugs and request features: Open issues on GitHub Issues.
5. Join the community chat: Come to Discord.
6. Help with translations: Contribute locale updates in packages/core/src/i18n/locales/.
7. Contribute code/docs: Open a pull request and follow the contribution guide and commit conventions.
8. Pick and build: Community members are welcome to pick any item in the Roadmap or any open issue and submit a PR.
9. Sponsor the project: Support ongoing development via GitHub Sponsors or Ko-fi.

Roadmap

• 📦 Add to Flathub
• 📱 Improve iOS experience
• 🗣️ iOS Reminders Inbox import (Siri capture -> Mindwtr Inbox)
• ⚡ iOS Shortcuts + URL scheme quick capture
• 🧩 iOS Home Screen widget
• 🔗 Obsidian integration (task deep links)
• ✉️ Email to Inbox

Documentation

• 📚 Wiki - Complete user guide
• 🚀 Getting Started
• ❓ FAQ
• 🔄 Data & Sync
• 📝 Release Notes Index