User Guide: Mobile

The Mindwtr mobile app provides the complete guided GTD workflow on iPhone and Android: capture, card-based Inbox processing with the two-minute rule, Projects, Focus, Daily Review, and the guided Weekly Review wizard. Android is fully supported; iOS is available on the App Store and via TestFlight beta. Mindwtr is built with React Native and Expo.

Overview

The mobile app uses bottom tabs for core flows and a Menu page for additional views.

Android navigation adapts to the available app window: roomy windows use a side rail, while narrow or short windows keep compact navigation. Task editors and Quick Capture fit within a usable pane when Android reports a separating or obstructing hinge. There is no foldable mode to enable. Foldable emulator checks cover these layouts; physical Galaxy Z Fold and Z Flip confirmation is still pending.

---

Interaction Patterns

• Tap to open a task. Settings → Task editor layout → Open tasks in decides which tab the tap lands on.
• Swipe for quick actions (see Swipe Actions section below).
• Share sheet adds items directly to your Inbox.

Navigation

Bottom Tabs

Tab	Description
📥 Inbox	Capture and process incoming items
🎯 Focus	Daily dashboard and next actions
➕ Quick Capture	Add a task or audio note quickly
📝 Review	Daily + weekly review
☰ Menu	Access Projects, Board, Calendar, etc.

Quick Access slots are customizable. In this clip, Review is changed to Projects; Projects then appears in both the bottom navigation and the Menu.

Customize Quick Access, replace Review with Projects, and open the Projects view from the updated navigation.

Menu Tab

Tap the Menu tab to access additional views:

• 📋 Board: Kanban board view with manual drag ordering, search, and context/tag/date/project filters
• 🗓️ Calendar: Time-based view
• 📁 Projects: Multi-step outcomes
• 🏷️ Contexts: Filter by context
• ⏳ Waiting For: Delegated items
• 💭 Someday/Maybe: Future ideas
• 📚 Reference: Reference material
• ✅ Done: Recently completed tasks
• 📦 Archived: Completed tasks and projects filed away from normal lists
• 🗑️ Trash: Deleted tasks and projects
• ⚙️ Settings: App preferences

Open Done and tap Select to choose tasks, then use Move → Archived to file them away early. In Archived, tap Select or Select All to move tasks back to Done without changing their completion time, restore them to Inbox, or move them to Trash. Switch to Projects to open, restore, or move archived projects to Trash. Mindwtr permanently deletes items only from Trash.

Archived has a search box and a Filters button in its header. Filters narrows by context, tag, priority, and time estimate, and holds Sort and Group — both offering Completion date, since everything filed here is finished work. The newest completion comes first by default. Filter selections are shared across the task lists, so a context picked elsewhere narrows this list too. Search and filters apply to the Tasks side of the Tasks | Projects switch.

In Done, sort by Completion date to show the newest completions first. Group by Completion date to split the list into Today, Yesterday, Previous 7 days, one heading per calendar month for anything older (January 2026, December 2025, …), and Not completed; empty groups stay hidden, and the ungrouped catch-all group comes last. References, Inbox, Done, and Archive can also group by Context. A task with several contexts appears in each matching group, while tasks without one collect under No context at the end. Tap any group heading to fold that group — each list remembers which of its groups are folded per grouping mode on that device, and a folded group’s tasks drop out of Select and the bulk actions.

Open Trash and tap Select to manage several deleted tasks and projects. Tap Select All or choose items, then restore or permanently delete them in one step. Permanent deletion always asks for confirmation.

---

Reference

Reference is for notes and material you want to keep. Its rows and editor emphasize the title, description, project or area, people, tags, attachments, and links. Task scheduling and completion controls stay out of the way. Use Convert to action when a reference becomes something to do. Existing checklist items appear as a plain list in Reference and remain editable. Their saved checked states return if you convert the reference back to an action.

Search within Reference matches every space-separated term anywhere in the title or description, ignoring case. For example, ke 1 2 matches key1 key2 key3. Terms are literal text; this field does not interpret quick-add or advanced search syntax.

Turn on Include archived projects in the Reference filters to find material from completed or archived projects. It starts off and applies only to this view on this device; deleted material stays excluded.

Bulk Actions

For Start, Due, and Review dates in Bulk organize, tap the calendar button or choose Today or Tomorrow. Dates apply only after Apply to selected and do not add a time or reminder. Leaving a date blank (or tapping its selected shortcut again) keeps each task's existing date.

In Bulk organize, search for a project or area, or type a new name and choose Create without losing your task selection or other form fields. Creation saves and selects the destination; tasks move only after Apply to selected. Cancelling the bulk edit leaves your tasks unchanged and keeps any destination you created. If creation fails, your selection and form stay available for retry.

---

Global Search

Tap the search icon in the header to open Global Search.

Search hides Done and Archived items by default. When hidden items match your query, a tappable "N more in Done and Archived" hint appears. Tap it to include them, or enable Include Done and Archived tasks in the search filters.

Search Operators

Use operators for powerful filtering:

Operator	Example	Description
status:	status:next	Filter by task status
-status:	-status:done	Exclude a status
context:	context:@home	Filter by context
tag:	tag:#focused	Filter by tag
assigned:	assigned:Tom	Filter by assignee
project:	project:HomeReno	Filter by project
location:	location:office	Filter by task location
where:	where:office	Alias for task location
id:	id:abc123	Find an exact task ID
-id:	-id:abc123	Exclude an exact task ID
due:	due:today	Tasks due on date
due:<=	due:<=7d	Tasks due within 7 days
start:	start:>=tomorrow	Tasks starting from date
created:	created:>=30d	Tasks created in last 30 days
OR	@home OR @work	Match either condition

A leading - negates any operator, not just the two shown: -context:@computer lists only tasks that don't require @computer, -tag:#deep hides a tag, -project:HomeReno excludes a project.

Saved Searches

Saved Searches are shortcuts for reusable search queries.

1. Enter your search query
2. Tap "Save Search"
3. Name your search
4. Access from Menu → Saved Searches

To delete: Open the saved search, tap the trash icon in the header.

Saved Searches are separate from Saved Filters in Focus. Focus filters save criteria such as projects, contexts, tags, priority, energy, and time estimates for the Focus view.

---

Quick Capture

Mindwtr offers multiple ways to capture tasks quickly on mobile.

The capture screen is input-first. The syntax help is tucked behind a small “?” toggle to keep the interface clean.

For capture bursts, turn on the Add another switch in the capture sheet: each Enter saves the task and keeps the sheet open with the keyboard up, ready for the next one. The switch stays on across captures until you turn it off.

Share Sheet

Capture tasks from any app using the share sheet:

1. In any app (browser, email, notes), find something you want to capture
2. Tap the Share button
3. Select Mindwtr from the share options
4. Mindwtr opens the capture screen with the shared content attached as notes
5. Add a title, adjust any fields, and save it to your Inbox

Sharing a file (a PDF, image, video, or audio recording) copies it into Mindwtr as an attachment on the new task, with the filename as the starting title. Up to six files can be shared at once.

Great for:

• Saving articles to read later
• Capturing emails as tasks
• Adding links from web browsing
• Filing a PDF or photo as an Inbox task to process later

Android automation capture

In Settings → GTD → Capture defaults, enable Automation capture and copy the capture token. This setting and token stay on this device. Give the token only to automation apps you trust; turning the setting off revokes it, and turning it on again creates a new token.

This is a general Android broadcast intent; Tasker is not required. Any app or automation tool that can send an explicit broadcast with String extras can use it. Send the action below to this receiver, with text containing the captured text and token containing your capture token:

Field	Value
Action	tech.dongdongbh.mindwtr.action.CAPTURE
Package	tech.dongdongbh.mindwtr
Class	tech.dongdongbh.mindwtr.androidwidget.CaptureIntentReceiver
Target	Broadcast Receiver
text (String)	Text to capture
token (String)	Your capture token

Tasker example

In Tasker, add Misc → Send Intent after the action that produces your dictated text:

Field	Value
Action	tech.dongdongbh.mindwtr.action.CAPTURE
Package	tech.dongdongbh.mindwtr
Class	tech.dongdongbh.mindwtr.androidwidget.CaptureIntentReceiver
Target	Broadcast Receiver
Extra	text:(String) %captured_text
Extra	token:YOUR_CAPTURE_TOKEN

Replace %captured_text with your Tasker text variable and YOUR_CAPTURE_TOKEN with the copied token. Leave the category, MIME type and data fields empty. Mindwtr Dev uses package tech.dongdongbh.mindwtr.dev; the action and class stay the same.

Each accepted capture is queued separately, including repeated text. Open Mindwtr to import the queued captures into Inbox. The intent does not open the app or sync in the background. It accepts nonblank text up to 2,000 characters; it does not accept audio or files. Start by sending two short notes before opening Mindwtr, then check that both arrive. Android force-stop can block broadcasts until you open the app again.

See Tasker’s intent guide for its Send Intent fields.

Home Widget

Tapping blank space in a Tasks or Compact widget opens Focus on Android and iOS. Task links, completion controls, list selection and quick capture keep their existing actions.

The controls below describe Android. For iOS, see iOS Home Screen Widget below.

Add the Mindwtr widget to your home screen for quick access:

1. Long-press on your home screen
2. Select Widgets
3. Find Mindwtr and add the Tasks widget, the one-cell Quick capture button or, on Android, the optional smaller Compact widget. The Tasks widget shows a + button and your tasks, each with its priority colour, its project or area, and its due date. On Android, a newly added Tasks widget shows Focus, with the inbox count in its header and a short view of Today's Focus and Today. Review Due, Next actions and Upcoming stay in the app. Tap the title to open that list in Mindwtr. To switch the widget's list, tap the separate small down arrow. The header follows the same theme background as the widget body. A sheet lists Focus, Inbox, Next Actions, Waiting For, Someday/Maybe and your Saved Filters. Tap one and the widget redraws. To show a single project on a widget, save a Focus filter for that project in the app and pick that filter here. This works on every launcher, and some launchers have no edit action of their own for widgets. You can add several Tasks widgets with different lists. After Mindwtr has run and published its first Android widget snapshot, the five standard lists are ready for newly added Tasks widgets and list changes without another app launch. Open Mindwtr once before using widgets and again to refresh their data; widgets do not follow background sync in real time. Mindwtr publishes saved-filter snapshots on demand.
4. On a task-list widget, tap a task to open its small native detail sheet. On Tasks, tap the ring at the start of a row to complete it. Use the capture button on any of the three Android widgets to add something to Inbox.

The Tasks widget prioritizes Today's Focus, followed by Today, including overdue tasks. It does not fill empty space with other next actions. On Android, it follows the Focus screen's filters and sort order. The filters you have set there apply to the widget too: contexts, tags, priority, energy, time estimate and a saved filter. The sort you have chosen on the Focus screen applies as well, and the widget updates when you change either. The area you have selected in the app narrows every widget list.

The Android Compact widget uses smaller text and a flat Focus list for small widget spaces. It shows Today's Focus and Today under the Today header. If both are empty and Next Actions are available, the header switches to Next Actions. Resizing the widget shows as many task rows as fit, up to the available tasks. It has no list chooser or inline completion control; tapping a task opens the same native detail sheet.

On Android, tapping a task row in Tasks or Compact opens a small task sheet over your home screen, without opening the main app. The sheet shows the title, the project or area, the note, the contexts and tags, the start and due dates, and the priority. Complete checks the task off the same way the Tasks ring does, with the same short undo window. Open takes you to the task in the app.

On Android, tapping a ring in the Tasks widget crosses out the row immediately. Tap it again within about three seconds to undo. After this window, the row disappears from Tasks and Compact, making room for the remaining tasks without opening the app. The completion stays saved on the device until Mindwtr next opens, applies it and syncs it to your other devices.

On Android, the capture button on any of the three widgets, the Quick Settings tile, the app shortcut and the capture notification open the same native floating capture window on top of whatever you are doing, without opening the main app. Save adds the task to the Inbox, shows a short confirmation and closes the window; the task appears the next time you open Mindwtr. iOS captures through the app as before.

Enabling speech-to-text also adds a microphone button to this native Android window. Record, tap Stop, then Save; the main app stays closed. Recordings are saved on the device and transcribed with your configured provider when Mindwtr next opens or returns to the foreground. F-Droid uses offline Whisper. Failed transcription keeps the recording for another attempt. Recording stops when you leave the window and is limited to five minutes.

On Android, dated rows show Today, a weekday for the coming week, or a compact date. Tasks due today or overdue receive extra emphasis.

Android Tasks and Compact lists scroll beyond 20 tasks. For a very large list, View all at the bottom opens the full selected list in Mindwtr. No task-count setting is needed.

iOS Home Screen Widget

Choose Tasks for the regular widget, available in small, medium and large sizes (plus extra-large on supported iPads), or Compact for smaller text and a flat Focus list. Compact has no list picker or check-off rings; medium and larger sizes still link to tasks and quick capture.

Tasks and Compact show Today's Focus and Today first, including overdue tasks. When that list is empty, they show Next Actions instead, with a short Today or Next heading to identify the list. They do not mix Next Actions into a nonempty Today list. Rows adapt to the widget's size and text size. The Tasks widget keeps the date, priority rings, project or area labels, and the app's filters, theme and sort order.

On iOS 17 and later, long-press a Tasks widget and choose Edit Widget to select Focus, Inbox, Next Actions, Waiting For, Someday/Maybe, or a saved filter. Multiple widgets can show different lists; an explicitly selected list other than Focus never falls back to another list. Tap a ring to queue completion and tap again within three seconds to undo. After that window, the row hides and another cached task can fill the space. WidgetKit may delay the visible refresh. The completion stays safely queued until Mindwtr runs and saves it; completion and sync happen through the app, not directly from the widget.

Tap the heading, empty state, or small widget to open the displayed list. Medium and larger widgets link task rows to their task in Mindwtr and + to quick capture; small-widget rings remain interactive on iOS 17+. Older iOS versions use the default Today/Next behavior without inline check-off or list configuration. WidgetKit controls refresh timing. Lock screen widgets are unchanged.

iOS Lock Screen Widget

On iOS 16 and later, Mindwtr offers lock screen widgets that show your current focused task without unlocking the phone:

1. Long-press the lock screen and tap Customize
2. Select the widget area and add a Mindwtr Focus widget
3. Choose the rectangular widget (top focused task with a Focus caption), the inline one-line widget above the clock, or the circular focused-task counter

Tapping any of them opens the Focus screen. Lock screen widgets follow the system's monochrome lock screen style.

Android Quick Settings Tile

On Android, add the Mindwtr capture tile to Quick Settings for one-swipe Inbox capture:

1. Open Android Quick Settings edit mode.
2. Add the Mindwtr tile.
3. Tap the tile to open the same small capture window described under Home Widget.

Android Notification Bar Quick Capture

For the fastest capture, one swipe and available from the lock screen, pin a persistent Quick capture notification:

1. Open Settings → Notifications.
2. Turn on Quick capture in notification bar.
3. Tap the notification any time to open the same small capture window described under Home Widget.

The notification is silent and stays out of the way at the bottom of the shade. Turn the toggle off to remove it. (Android only; iOS doesn't support persistent notifications, so use the widget or Shortcuts there.)

Android Voice App Actions

Android builds expose a capture action to supported assistants, including Gemini/Assistant surfaces that route through Android App Actions. Voice-created captures open Mindwtr's confirmation flow so you can review the title and note before saving.

Android System Search

Turn on Settings → General → Expose to system search (off by default, Android 12+) to let system search and compatible launchers find your tasks, projects, and areas by title. The index stores only titles plus minimal status, due-date, and project/area metadata — never descriptions, notes, or attachments — and nothing leaves the device. Tapping a result opens the item in Mindwtr, and turning the switch off removes everything from the index.

Android Context Automation Intents

Automation apps such as Tasker, MacroDroid, or Phone Profiles can activate a Mindwtr context. Use the Android broadcast form for background-only triggers. When activated, Mindwtr checks matching /next actions that are available now and sends a notification only when there is work to show. Tapping that notification opens the matching Contexts view.

Android broadcast form:

Field	Value
Package	tech.dongdongbh.mindwtr
Class	tech.dongdongbh.mindwtr.ContextAutomationReceiver
Target	Broadcast Receiver
Activate action	tech.dongdongbh.mindwtr.action.ACTIVATE_CONTEXT
Deactivate action	tech.dongdongbh.mindwtr.action.DEACTIVATE_CONTEXT
String extra	context=parents or context=@parents

ADB examples:

adb shell am broadcast -n tech.dongdongbh.mindwtr/.ContextAutomationReceiver -a tech.dongdongbh.mindwtr.action.ACTIVATE_CONTEXT --es context parents
adb shell am broadcast -n tech.dongdongbh.mindwtr/.ContextAutomationReceiver -a tech.dongdongbh.mindwtr.action.DEACTIVATE_CONTEXT --es context parents

URL form:

URL	Action
mindwtr://contexts?token=%40parents&contextAction=activate	Activate @parents
mindwtr://contexts?token=%40parents&contextAction=deactivate	Deactivate @parents

URL examples:

adb shell am start -a android.intent.action.VIEW -d 'mindwtr://contexts?token=%40parents&contextAction=activate' tech.dongdongbh.mindwtr

Notes:

• URL launches may open Mindwtr. Use the broadcast receiver form when the automation should stay in the background.
• Context names are normalized to @context, so parents and @parents both match @parents.
• Hierarchical contexts match below the selected context, so @parents also matches @parents/errands.
• If no currently available /next actions match the context, Mindwtr stays silent.
• Deactivation is a silent no-op for now. It acknowledges the automation exit trigger and is reserved for future active-context state; it does not delete, hide, or change tasks.
• On Android, context automation URLs and intents return Mindwtr to the background after handling. Use the notification tap when you want to open the matching Contexts view.
• Mindwtr does not detect locations or device states itself; the automation app owns the trigger.

Apple Shortcuts

On iPhone and iPad, Mindwtr exposes native Apple Shortcuts actions for Inbox capture and opening GTD views such as Focus, Waiting, Someday, Projects, Review, and Calendar. See Apple Shortcuts for setup, examples, and v1 limitations.

Apple Watch companion

The native Apple Watch companion supports watchOS 10 or later and has been tested on a paired physical Watch. Install Mindwtr on the Watch from the iPhone Watch app.

• Capture: Tap Speak to Capture to record audio on the Watch for iPhone transcription. Tap Type to enter text; the iPhone may offer its keyboard as an optional input method. Captures enter Mindwtr's local Inbox, so cloud sync is optional.
• Focus: Review Focus tasks, mark one complete, or defer it until tomorrow.
• Pomodoro: Start and control the timer linked to Mindwtr on the iPhone.

The Watch keeps captures queued when the phone is unavailable and delivers them when the connection returns.

URL Scheme Quick Capture (iOS Shortcuts / Android Automations)

Mindwtr registers the URL scheme mindwtr://, so you can capture tasks from iOS Shortcuts, Tasker, or other automation tools.

Supported URLs:

URL	Action
mindwtr://capture?title=Buy%20groceries	Open capture with a title
mindwtr://capture?title=Buy%20groceries&note=From%20store	Open capture with title and note
mindwtr://capture?title=Buy%20groceries&project=Shopping&tags=errands,home	Open capture with project and tags

Notes:

• title is required (alias: text).
• note is optional (alias: description).
• project matches an existing active project by title (case-insensitive), or creates it.
• tags is comma-separated and normalized to #tag format before saving.

iOS Shortcuts example:

1. Open Shortcuts and create a shortcut.
2. Add Ask for Input (prompt: task title).
3. Add Open URLs with: mindwtr://capture?title=[Provided Input].
4. Run the shortcut; Mindwtr opens the capture screen so you can review and save the task.

Quick-Add Syntax

Mindwtr parses natural language when adding tasks:

Syntax	Example	Result
@context	@home	Adds context
#tag	#focused	Adds tag
+Project	+HomeReno	Assigns to project
+Multi Word	+New Project	Assigns to "New Project"
+"Quoted Name"	+"New Project" call Bob	Quotes delimit a multi-word name mid-sentence (also !"Area Name")
!Area	Plan roadmap !Work	Assigns to area
%Person	Ask %Jim for budget	Sets Assigned to (delegated / waiting-for owner); %"Full Name" for new multi-word names
/area:<name>	/area:Personal	Assigns to area (no spaces)
/due:date	/due:friday	Sets due date
/energy:<level>	/energy:medium	Sets energy level (low, medium, high)
/priority:<level>	/priority:high	Sets priority (low, medium, high, urgent)
/note:text	/note:call back	Adds description
/status	/next, /waiting, /someday, /reference, /done, /archived, /inbox	Sets status

Date formats: today, tomorrow, friday, next week, in 3 days, 2025-01-15, 26.06., 26.06.2026

A date or time phrase at the end of what you type becomes the due date: Grab a coffee with Marta Jun 23 6pm creates a task due June 23 at 6pm. Detection only reads the end of the text, so a title like "Review June report" stays untouched. By default those matched words stay in the title; turn on Clean up quick add text (Settings → GTD) to remove them too, leaving "Grab a coffee with Marta". The setting covers only this ambiguous case — syntax the parser recognizes and applies always leaves the title. Turn off Detect natural-language dates (Settings → GTD, on by default) to keep date phrases literal with no date set. Explicit tokens like /due:friday work regardless and take priority over detection. Both settings sync across your devices. When the app runs in German, Spanish, French, Italian, Japanese, Dutch, Portuguese, Russian, Swedish, or Chinese, date phrases in that language are detected too — English phrases keep working in every language.

---

Audio Capture

Capture tasks using your voice with AI-powered transcription.

Setup

1. Go to Menu → Settings → Advanced → AI Assistant.
2. Enable Speech to Text.
3. Choose a Provider:
   • OpenAI / Gemini: Cloud-based (requires API key).
   • Offline (Whisper): Runs locally. You can download a model (e.g., Tiny or Base) directly in settings.
4. Set your Default Capture Method in Settings → General if you prefer audio-first.

Using Audio Capture

• Quick Add: Tap the Audio tab in the Quick Capture screen.
• Record: Tap the microphone to start.
• Transcribe: Stop recording to process the audio.
• Smart Parse: If enabled, the app will extract dates and fields automatically.

---

Inbox

Your capture zone for quick task entry.

Use Mind Sweep when you want guided capture prompts for work, home, people, errands, and open loops instead of starting from a blank input.

Adding Tasks

1. Tap the input field at the bottom
2. Use the share sheet from other apps
3. Tap the home widget
4. Type your task with quick-add syntax
5. Tap the add button or press Enter

Processing Inbox

Tap Process Inbox to start the clarify workflow:

1. Is this actionable?

   • Yes → Continue
   • No → Trash or Someday/Maybe

2. Will it take less than 2 minutes?

   • Yes → Do it now, mark Done
   • No → Continue

3. Who should do it?

   • I'll do it → Add context, move to Next Actions
   • Delegate → Move to Waiting For

4. Where will you do this?

   • Select contexts (@home, @work, etc.)
   • Add custom contexts

5. Assign to a project? (Optional)

   • Select a project or skip
   • Or choose Yes, make it a project when the capture holds several actions: name the project and define its next action. Any further actions you type land back in the Inbox with the project already attached, ready for their own clarify pass

---

Focus

Your primary dashboard for doing. Focus is an Engage dashboard, not a full inventory of every task with status next.

Sections

Section	Content
Today	Tasks focused for today, due today/overdue, or starting today, including later today, with those rows showing their start time until it arrives
Next	Available next actions that are not blocked or deferred
Upcoming	Read-only preview of next actions starting or recurring on another day within 7 days

Focus keeps future-start tasks and later tasks in sequential projects out of its actionable lists so they stay limited to what you can act on now; deferred tasks landing within the next week still show in the Upcoming preview, with the date each will appear. Use Contexts, Projects, or Search when you want to inspect the broader task inventory.

Default Next Actions order is due-soon actions first, undated actions next, and far-future due actions last. Within the same bucket, Focus uses priority when enabled, then start time, creation date, title, and id. See GTD Workflow in Mindwtr for the full logic.

The list icon beside Filters in the Focus header toggles Details: turn it off and every row collapses to its title, hiding the description preview and metadata line, with each device remembering the choice.

Features

• Context filter: Tap a context chip to filter the Next list.
• Saved Filters: Save reusable Focus criteria such as projects, contexts, tags, priority, energy level, and time estimates. Tap a saved filter to apply it; tap it again or tap All to clear it. To delete a saved filter, long-press its chip and confirm Delete. Screen readers also offer a delete action on each saved filter.
• Swipe to Focus: Swipe a task right to toggle "Focus" status (moves it to Today).
• Quick Status: Tap the status badge to change status.
• Pomodoro (Optional): Enable in Settings → GTD → Features → Pomodoro timer to show a compact focus/break timer. Leave it as Timer only, or turn on Link timer to task to show the Timer task picker and Mark task done action. Collapse the card to keep the remaining time, phase, and Running or Paused status visible in a slim row.

---

Review

Review your tasks and update their status.

• See task details (description, start time, deadline, contexts)
• Quickly mark tasks as done
• Navigate between tasks
• Select mode: Batch organize, move, tag, share, or delete tasks
• During Weekly Review, use the Process Inbox step to clear captured items before continuing through calendar, waiting-for, projects, and someday review.

---

Task Editor (Task + View)

The task editor has two modes:

• Task: edit fields, checklists, dates, tags, contexts
• View: clean read-only summary with tappable checklist

Swipe left/right to switch between Task and View.

Settings → GTD → Task editor → Open tasks in controls the opening mode on this device:

• Automatic (default): Inbox tasks open in Edit; other lists open in Preview.
• Preview: read the task first.
• Edit: go straight to the fields. The keyboard stays closed until you tap a field.

This works the same on Android and iOS. Explicit Edit actions still open Edit, and read-only tasks stay in Preview. Switching tabs for one task does not change this preference.

The editor starts minimal. Tap More options to reveal advanced fields; any field with existing content stays visible.

Description markdown supports unordered lists and task checkboxes (- item, [ ] item, [x] item). Type [[ in task descriptions or project notes to link another task or project from the link picker sheet. Those links are navigational only; they do not sync completion state between tasks. Markdown checkboxes in the description are notes-only; they do not affect the task checklist. Pasting multi-line text into a checklist item creates one item per line (bullets, numbering, and [x] markers are recognized). The Assignee / Person field stores delegated people for Waiting For, suggestions, and assigned: search. Manage saved people, notes, and reference links from Settings → Manage.

Recurring tasks support two strategies:

• Strict (fixed cadence)
• Repeat after completion (next date from completion time)
• Ends: Never / On date / After N occurrences

Mindwtr keeps one active instance of a recurring task. The Calendar shows that current instance when it has a due date or start time; future occurrences are not pre-filled until the current one is completed unless Show future occurrences in Calendar is enabled for a planning-only preview.

Use the recurrence field in the task editor, then toggle Repeat after completion or Show future occurrences in Calendar when needed. The same sheet lets you stop a series on a target date or after a fixed number of total occurrences.

Attachments

You can attach files or links to a task from the editor. Audio notes can be saved as attachments when Save audio attachments is enabled.

See Attachments for details on syncing and cleanup.

---

AI Assistant (Optional)

Enable in Settings → Advanced → AI assistant:

• Clarify: turn vague tasks into concrete next actions
• Break down: generate checklist steps for big tasks
• Review analysis: highlight stale tasks during review
• Copilot: context/tag/time suggestions while typing

AI is optional and only runs when you request it.

---

Reusable Lists

Use checklists as templates:

• Duplicate task: copy a master list (packing, travel prep)
• Reset checklist: uncheck everything for reuse (groceries)

---

Calendar Integration

Mindwtr can overlay external calendars and push dated Mindwtr tasks to the device calendar. Detailed setup lives in Calendar Integration.

To push tasks to Android/Google Calendar or Apple Calendar on iOS:

1. Go to Menu → Settings → Advanced → Calendar
2. Enable Push tasks to calendar
3. Grant calendar permission
4. Expand Sync target
5. Choose a dedicated Mindwtr calendar or another writable calendar target

For Android Google Calendar and iOS Apple Calendar target setup, see Calendar Integration.

To overlay external calendars with ICS subscriptions:

1. Go to Menu → Settings → Advanced → Calendar
2. Add your ICS URL
3. Refresh to fetch events

External events are view-only and are not synced back to their source. Tap an external event and choose Create task to make a separate Mindwtr task; Mindwtr copies the event title, date/time, location, description, and calendar name where available.

---

Calendar

Time-based view with scheduling capabilities.

Views

• Month View: Overview of tasks with due dates
• Day View: Detailed timeline with scheduled tasks and external events

Scheduling Tasks

1. On the Calendar day view, tap Schedule Tasks
2. Select from Next Actions (shown first) or search Todo tasks
3. Mindwtr finds the earliest free slot (avoids conflicts with external events)
4. Task gets a start time based on its time estimate

The scheduling panel is the mobile planning surface: use it when you are looking at a day and want to turn unscheduled Next Actions or due-but-unscheduled work into concrete time blocks. Collapse it when you want to focus on the calendar grid.

Drag to Reschedule

• Long-press a scheduled task block
• Drag to a new time slot (snaps to 5-minute intervals)
• Release to update the start time

External Calendars (iCal/ICS)

Subscribe to external calendars to see events alongside your tasks:

1. Go to Menu → Settings → Advanced → Calendar
2. Enter the calendar URL (ICS/webcal format)
3. Give it a name and tap Add
4. External events appear as gray blocks in Day view

---

Projects

Manage multi-step outcomes.

Open Projects from Menu → Projects.

Project List

• View all active projects
• See task count per project
• Tap to view project details

Project Details

• View all tasks in the project
• See the project's reference material in a References section below the task list — references whose tags match the project's tags appear there too
• Add new tasks
• Group tasks with Sections inside the project. Sections are headings inside one project, not subtasks or separate projects.
• Tap a task to assign a Section in the task editor
• Edit project settings (name, color, notes)
• Assign Area of Focus (e.g., Work, Personal)
• Add Project tags for filtering
• Set sequential or parallel mode
• Set review date
• Reorder project tasks with the drag handle when custom ordering is enabled. Dropping a task under a different section header moves it into that section, and dropping it above the first header clears its section
• Complete the project from Actions in the project details — remaining tasks are completed with it, the project moves to the Completed section at the bottom of the project list, and Reactivate undoes it
• Duplicate the project — swipe its row to the right in the project list, or use Duplicate in the project detail sheet — to copy its sections and tasks into a fresh copy (see Reusable Lists)

The Project Section field in the task editor assigns a task to one of the sections in its current project. It only matters after the task belongs to a project that has sections; otherwise, leave it blank.

Sequential vs Parallel

Mode	Behavior
Sequential	Only the first available project task appears in Focus
Parallel	All available project tasks can appear in Focus

Sequential projects can run project-wide or section-by-section. Section-scoped sequencing shows the first available task in each project section, so separate phases or workstreams can move forward in parallel without making every task visible.

---

Swipe Actions

Quickly manage tasks with swipe gestures:

View	Swipe Right	Result
Inbox	Done	Marks task as done
Focus	Focus	Toggles focus status

Completing a task stamps the current time. If you actually finished earlier, long-press any Done control to pick the real completion time instead: the swipe-revealed Done button, the Done option in the status menu, the Done chip in the task editor, or the status badge in the task preview. You can also tap the Completed timestamp on a done or archived task to correct it afterwards.

---

Contexts

Browse and filter tasks by context.

Location Contexts

• @home: Tasks to do at home
• @work: Tasks for the office
• @errands: Out and about
• @agendas: Discussion items
• @computer: Need a computer
• @phone: Need a phone
• @anywhere: Can do anywhere

Tags

Filter tasks by energy level, mode, or topic:

• #focused: Deep work requiring concentration
• #lowenergy: Simple tasks for tired moments
• #creative: Brainstorming and ideation
• #routine: Repetitive/mechanical tasks

---

Waiting For

Track items delegated or waiting on external events.

• View all waiting tasks
• See deadlines
• Move to Next when ready
• Mark as Done when received

---

Someday/Maybe

Organize tasks into Someday sections directly from this list.

• Open a task’s menu and choose Move to section….
• Select several tasks to move them together with the same action. The picker includes empty sections, No section, and New section….
• Use New section… in the list to create a heading. When grouped by Someday section, use Add task on a heading to create a task in that section.
• A saved move offers Undo. Section changes preserve the task’s status, project, project section, and dates. Manage section names and ordering in Settings → Manage.

Incubate ideas for the future.

• Review periodically during Weekly Review
• Activate by moving to Next status
• Archive if no longer relevant

---

Notifications & Reminders

Mindwtr sends notifications to keep you on track.

Types of Notifications

• Due date reminders: Alerts when tasks are due
• Start time alerts: Reminds you when it's time to begin
• Recurring task reminders: Notifications for recurring items

Tasks with a due time can set Repeat reminder to 5, 10, 15, 30, or 60 minutes after the due reminder. Skip reminders turns off start and due reminders for that task. These are separate controls: Repeat reminder: Off does not turn off the first due reminder.

Test a task reminder

1. Edit a task and set its Due date to a time a few minutes ahead. Date only gives the task a deadline without scheduling a timed alert.
2. Check Skip reminders. Off means this task can alert you; On means its start and due alerts are skipped. In older versions, a blue outline around Skip reminders means it is On.
3. Tap Save. In Settings → Notifications, make sure task notifications and due reminders are enabled. On iOS, also allow Mindwtr notifications in the device’s Settings.
4. Wait for the due time. If you changed the task on another device, open Mindwtr on this phone so the new time syncs before the alert.

Tap the notification body to jump directly to the Review screen.

Reminders are scheduled on the phone itself. There is no push server. If you complete or reschedule a task on another device (for example, checking off a daily recurring task on desktop), the phone updates its alarms as soon as that change syncs over, so let the phone sync before the next reminder time (opening the app once is enough).

Permissions

Make sure notifications are enabled:

1. Go to device Settings → Apps → Mindwtr
2. Enable Notifications
3. Allow alerts and sounds as desired

Reminders arriving late on Android

Android 12 and later can withhold permission to schedule exact alarms. Without that permission, Android may delay reminders; there is no one-minute limit. Mindwtr shows Reminders may arrive late in Settings → Notifications, with an Allow button. Pomodoro shows its own explanation directly below Alert when timer ends, with an Open Android settings action. The switch controls whether you receive timer alerts; the Android permission controls their timing. Permission help appears only while Pomodoro alerts are on and the permission is missing.

Tap Allow to open the Android permission screen for Mindwtr. You can also reach it at device Settings → Apps → Mindwtr → Alarms & reminders. As soon as the permission is granted, Mindwtr reschedules its reminders as exact alarms without restarting the app, and the row goes away. The row never appears before Android 12, where every alarm is already exact.

---

Settings

General

• Appearance: System, Light, Dark, Material 3 (Light), Material 3 (Dark), E-Ink, Nord, Catppuccin Macchiato, Dracula, Sepia, or OLED / Midnight
• Language: English, Chinese (Simplified), Chinese (Traditional), Hindi, Spanish, Arabic, French, Portuguese (Brazil), Russian, German, Japanese, Persian, Vietnamese, Turkish, Korean, Italian, Polish, Dutch, Czech, Swedish, Danish, Hungarian, Ukrainian

Notifications

Task Reminders:

• Enable/disable notifications for due dates and start times

Daily Digest:

Morning and evening digests have their own switches. They work even when Task Reminders is off; notification permission is still required.

• Morning Briefing: Summary of due today, overdue, and focus tasks
• Evening Review: Prompt to review and wrap up the day
• Configure times for each

Weekly Review:

• Reminders: Get a weekly notification to start your review
• Time/Day: Customize when you want to review (e.g., Friday at 4 PM)

GTD

Customize how Mindwtr works for your GTD workflow:

Features (Optional):

• Priorities: Show a priority flag on tasks
• Time Estimates: Add a duration field for time blocking

Time Estimate Presets:

• Choose which time estimates appear in the task editor
• Options: 5m, 10m, 15m, 30m, 1h, 2h, 3h, 4h, 4h+
• Default: 10m, 30m, 1h, 2h, 3h, 4h, 4h+

Auto-Archive:

• Automatically move Done tasks to Archived after a set number of days (default: 7 days). Reducing the delay immediately archives existing Done tasks that are now older than the new limit. Otherwise the check runs every time the app starts, and correcting a task's completion time to something older than the limit files it away straight away.
• Set to "Never" to keep completions in the Done list indefinitely

Inbox Processing:

• Mobile keeps the card-based inbox processing flow
• The same shared settings can hide or show the 2-minute shortcut, project-first prompt, contexts/tags section, scheduling section, and reference option

Task Editor Layout:

• Open tasks in decides which tab a normal task tap opens: Automatic (Edit from the Inbox, Preview everywhere else), Preview, or Edit. A read-only task always opens in Preview, and an explicit edit action always opens Edit. The choice stays on this device and is not synced.
• Tap a field to toggle visibility (hidden fields still show when they have values)
• Long-press the drag handle to reorder fields
• Move fields between sections like Basic, Scheduling, Organization, and Details
• Choose which collapsible sections open by default
• Hidden fields can be revealed with the More button in the editor

Manage:

• Use Settings → Manage to edit saved Areas, People, Contexts, and Tags
• This is the fastest place to clean up duplicates or rename reusable metadata
• See Areas and People for where to create Areas and People while assigning them

Data & Sync

See Data and Sync for sync setup.

Sync Backend:

• Cloud Sync: Dropbox in supported builds, plus iCloud on iOS where available
• Folder / File Sync: File sync via a shared JSON file/folder (Google Drive, Syncthing, OneDrive, etc.)
• Advanced / Custom Server: WebDAV or Self-Hosted Mindwtr Cloud

Other Options:

• Sync: Manually trigger sync
• Last sync status: View when data was last synced
• Sync history: Collapsed by default; tap to expand recent entries
• Export Backup: Save data to a file
• Export Mindwtr CSV: Save a spreadsheet-friendly task export that can be re-imported without duplicating existing tasks
• Export TaskNotes: Save one Markdown file per task in a ZIP for Obsidian's TaskNotes plugin
• Apple Reminders import: Choose a Reminders list and import incomplete reminders into Inbox. Imported reminders remain in Apple Reminders, and already imported, completed, or untitled reminders are skipped.
• Settings sync options: Choose which preferences sync across devices (theme, language/date format, GTD defaults, external calendar URLs, AI settings, and Saved Filters). API keys and local model paths are never synced.

GTD Options:

• Focus task limit: Choose how many tasks can be marked for Today's Focus.

Advanced

AI Assistant:

• Optional BYOK assistant for clarifying and breaking down tasks

Calendar (ICS/iCal):

• Add Calendar: Enter a name and URL
• Enable/Disable: Toggle visibility of each calendar
• Remove: Delete a subscription
• Test: Verify the calendar loads correctly

About

• Version number
• Check for updates
• Send feedback for bug reports, feature requests, or other notes when the build has feedback enabled. You can include a reply email if you want follow-up.
• Website and GitHub links
• Privacy policy link

---

See Also

• Mobile Installation
• Apple Shortcuts
• Data and Sync
• GTD Workflow in Mindwtr