Help Guide

Introduction

Flowcus is an intelligent task management application for macOS that helps you collate your tasks into a single, holistic view so you can visualise them more effectively. It integrates with OmniFocus, Things, Todoist and TaskPaper.

Unlike traditional task managers that present tasks as flat lists, Flowcus organises your tasks into a Kanban board with columns representing workflow stages (like "To Do," "In Progress," "Done") and swimlanes for categorisation. But Flowcus goes beyond visualisation — it actively helps you work better by surfacing what matters, identifying what's being neglected, and automating the organisational work that slows you down.

Key benefits of Flowcus include:

• Intelligent Task Surfacing: Radar analyses your tasks daily and presents the 3–5 you should focus on, scored by urgency, momentum, and neglect
• Ghost Detection: Finds tasks you've been avoiding, vaguely defined items, and work that's slipped backward — before they become dead weight
• Task Manager Integrations: Connect to OmniFocus, Things, Todoist and TaskPaper
• Rule-Based Automation: Automatically assign tasks to the right columns and swimlanes based on rules you define
• Multi-Tag Support: Slice your work across multiple dimensions that a single category never could
• Command Palette: Drive everything from the keyboard with natural language commands
• Task Inspector: View full task context without leaving the board
• Sidekick: An AI assistant built directly into your workflow for task refinement, natural-language board control, and weekly reflection
• Customisable: Configure columns, swimlanes, filters, and WIP limits to match how you work

Whether you're a productivity enthusiast or just looking for a better way to stay on top of your work, Flowcus provides a powerful, yet intuitive interface for managing your tasks.

Getting Started

System Requirements

• Any Mac (Apple Silicon or Intel)
• macOS 13.0 (Ventura) or later
• Approximately 100 MB of disk space
• For OmniFocus integration: OmniFocus 3 or later (Pro edition required)
• For Things integration: Things 3 or later

Installation

1. Download and install Flowcus
2. Launch Flowcus from your Applications folder or Launchpad

First Launch

When you first launch Flowcus, an onboarding guide walks you through connecting your task manager, setting up your board columns, and understanding the key features. You can revisit the guide at any time from the Help menu.

Connecting to Task Sources

Flowcus works with these task sources:

OmniFocus Integration

1. In Flowcus, go to Settings → Sources
2. Enable "OmniFocus"
3. Note: You will need to grant permission if macOS asks if Flowcus can control OmniFocus
4. Your OmniFocus tasks will appear on the Kanban board
5. Large OmniFocus databases: If your OmniFocus database contains more than 500 tasks, Flowcus will offer you the option to configure folder filters before syncing. Filtering to only the folders you actively use should make syncing faster. You can configure folder filters at any time in Settings → Sources.

Things Integration

1. In Flowcus, go to Settings → Sources
2. Enable "Things"
3. Note: You will need to grant permission if macOS asks if Flowcus can control Things
4. Flowcus communicates with Things via JXA (JavaScript for Automation) and the Things URL scheme — you will need to provide your Things authentication token in Settings → Sources so that Flowcus can access your tasks
5. Your Things tasks will appear on the Kanban board

Todoist Integration

1. In Flowcus, go to Settings → Sources
2. Enable "Todoist"
3. Sign in to your Todoist account when prompted
4. Your Todoist tasks will appear on the Kanban board

TaskPaper Integration

1. In Flowcus, go to Settings → Sources
2. Enable "TaskPaper"
3. Select a TaskPaper file to use as your task source
4. Your TaskPaper tasks will appear on the Kanban board

You can use multiple task sources simultaneously and visualise tasks from all of them together on a single board.

Core Concepts

The Kanban Board

The Kanban board is where everything comes together. Your tasks are laid out in columns (workflow stages) and swimlanes (categories), moving from left to right as they progress. At a glance you can see what's queued up, what's in flight, and what's done — across all your task sources on a single board.

From the board you can:

• Move tasks between columns to update their status
• Drag tasks between swimlanes to recategorise them
• Filter tasks by tags, projects, or other criteria

The board is built from three core components:

• Columns: The stages your work moves through (e.g. To Do → Doing → Done)
• Swimlanes: Horizontal rows that group work by project, priority, or any category you choose
• Task Cards: Individual cards showing key details like name, tags, due date, and progress

Columns and Workflow Stages

Columns represent stages in your workflow. By default, Flowcus includes:

• To Do: Tasks that haven't been started
• Doing: Tasks you're currently working on
• Done: Completed tasks

Each column has a type:

• Queue columns: Hold tasks waiting to be worked on
• Active columns: Contain tasks actively being worked on
• Completed columns: Hold finished tasks
• Dropped columns: Contain discarded/unwanted tasks

Tasks move from left to right as they progress through your workflow. You can customize columns to match your specific process.

Swimlanes

Swimlanes provide horizontal organization across your kanban board. They can represent:

• Projects
• Categories
• Priority levels
• Custom groupings

Each swimlane contains its own set of tasks across all columns, allowing you to track progress within specific categories.

Task Cards

Task cards represent individual tasks and display key information:

• Task name
• Project (if applicable)
• Tags
• Due date
• Task age
• Checklist progress (e.g. "2/5" items complete)
• Flags and indicators
• Blocked status

Task Management

Creating Tasks

You can create new tasks directly from the Flowcus board. New tasks are synced back to the connected task source so everything stays in one place. To create a task, use the Command Palette (⌘⇧P) or right-click on a column and choose "New Task."

Task Inspector

The Task Inspector gives you full context on any task without leaving the board. Click on a task card (or press Enter with a task selected) to open the inspector panel, where you can:

• View and edit task name, notes, and due date
• Manage multiple tags
• See the task's full history of state changes
• View which column and swimlane the task belongs to
• Check blocked status and blocking reasons
• Flag or unflag the task

The inspector keeps you in flow by providing everything you need in a side panel rather than forcing you to switch views or applications.

Sidekick

Flowcus includes Sidekick — an AI assistant built directly into your workflow. Sidekick integrates with your local or remote LLM and brings AI into your task management without leaving the board. Use it to:

• Refine tasks: Improve vague or poorly defined tasks into clear, actionable next actions (individually or in batches)
• Control the board in natural language: Type commands like "show overdue tasks" or "move Design tasks to Doing" and Sidekick executes them
• Rewind your week: Generate a narrative summary of what you completed, dropped, and deferred over the past 7 days

Sidekick is designed to assist your thinking, not replace it — helping you articulate and organise work more effectively.

Checklists

Checklists let you track subtasks directly on a task card without leaving the board. If a task has subtasks, they appear as checklist items in Flowcus.

Viewing Checklists

Tasks with subtasks display a checklist badge on the card showing progress (e.g. "2/5"). Click the badge to expand the checklist and see all items.

Managing Checklist Items

From the expanded checklist panel you can:

• Toggle complete/incomplete — Click the checkbox next to an item
• Add a new item — Click the "+" button at the bottom of the checklist
• Rename an item — Click on the item name to edit it inline
• Remove an item — Click the delete button next to an item

Changes sync back to your task manager immediately.

Things to Know

• Only direct children are shown — nested subtasks (grandchildren) are not included
• Dropped subtasks are hidden from the checklist
• OmniFocus: In sequential projects, all subtasks appear in the checklist regardless of availability. When you complete a repeating subtask, OmniFocus assigns it a new ID — refresh the board (⌘R) to see the updated state
• Things: Checklists are not currently available for Things tasks due to a limitation in the Things scripting API
• Todoist: Subtasks in Todoist appear as checklist items and sync both ways
• TaskPaper: Child items within a TaskPaper project appear as checklist items

Moving Tasks Between Columns

Moving tasks between columns updates their status in your workflow:

Using Drag and Drop

1. Click and hold on a task card
2. Drag it to the desired column
3. Release to drop the task in the new column

Using Keyboard

1. Select a task by clicking on it
2. Press the Space key (or ⌘-]) to move it to the next column
3. Press ⌘-[ to move it to the previous column

When a task is moved to a completed or dropped column, it's automatically marked as completed or dropped in the source.

Completing Tasks

You can complete tasks either by:

1. Dragging a task to a completed column
2. Selecting a task and pressing ⌘⇧↩ (Command+Shift+Return)

Blocking and Unblocking Tasks

When you're waiting on something external before you can continue a task, you can block it:

Blocking a Task

1. Right-click on a task and select "Block Task" or press b
2. Enter a reason for blocking (optional)
3. Click "Block"

Blocked tasks display a visual indicator and can include a note explaining why they're blocked.

Unblocking a Task

1. Right-click on a blocked task or press b
2. Select "Unblock Task"

Tags and Flags

Flowcus supports multiple tags per task, letting you slice your work across different dimensions that a single category never could.

• Tags appear on task cards as coloured badges
• You can add, remove, and manage tags from the Task Inspector
• Use tag filtering (⌘⇧T) to show only tasks with specific tags
• Flagged tasks display a flag icon and have a highlighted border
• Toggle flags via the context menu or by pressing ⇧⌘L with a task selected

Rule-Based Assignments

Rule-based assignments automatically place tasks into the right columns and swimlanes based on criteria you define. Instead of manually dragging every new task to its correct position, you can set up rules that do it for you.

Rules can be based on:

• Tags
• Task source (OmniFocus, Things, Todoist, TaskPaper)
• Project or folder
• Flags and other task properties

To configure rules:

1. Click on ... in a column or swimlane header
2. Choose "Assignment Rules"
3. Define your criteria

When new tasks arrive on the board, they're automatically placed according to your rules — keeping your board organised without manual effort.

Command Palette

The Command Palette provides fast, keyboard-driven access to everything in Flowcus. Open it with ⌘⇧P and start typing to:

• Navigate to any task, column, or swimlane
• Execute commands using natural language
• Create, move, complete, or block tasks
• Open settings, toggle views, and switch filters
• Access Sidekick actions

The Command Palette supports natural language input, so you can type commands the way you'd describe them rather than memorising specific syntax.

Customisation

Configuring Columns

Customize your workflow by configuring columns:

• Click on ... in a column header to access customisation options
• Click + to the right of the board to add a new column

Setting Up Swimlanes

• Click on ... in a swimlane header to access customisation options
• Click + at the bottom of the board to add a new swimlane

Filtering Tasks

Tag Filtering

Filter tasks by their associated tags:

1. Open the tag filter with ⌘⇧T
2. Select one or more tags to show only tasks with those tags
3. Use the "Untagged" option to show tasks without any tags
4. Clear filters by clicking the "Clear Filters" button

Keyboard Shortcuts

Shortcut	Action
⌘⇧P	Open Command Palette
⌘⇧T	Open tag filter
⌘,	Open settings
⌘K	Toggle project information display
Enter	Open Task Inspector for selected task
⌘⇧↩	Complete selected task
⌘] or Space	Move selected task to the next column
⌘[	Move selected task to the previous column
⇧⌥↑	Move selected task to the previous swimlane
⇧⌥↓	Move selected task to the next swimlane
B	Block or unblock selected task
⇧⌘L	Toggle flag on selected task
⌘R	Refresh the board

Advanced Features

Flowcus Radar

Radar analyses your open tasks each day and presents the 3–5 you should focus on, scored by urgency, momentum, and neglect — with clear reasons why each one ranked. It surfaces what matters so you can start your day with confidence rather than scanning your entire board.

How scoring works

Each task starts at 0 points. Points are added or subtracted based on these factors:

A task can earn points from multiple reasons. For example, a flagged task that's also overdue and aging would score 10 + 4 + 3 = 17.

What each reason means

• Overdue — This task is past its due date. It's the strongest signal that something needs action.
• Due today — The deadline is today. Handle it before it becomes overdue.
• Aging — This task has been sitting around for over a week. It may be something you keep putting off.
• Flagged — You explicitly marked this task as important in your task manager.
• Momentum — This task is in your active (Doing) column but hasn't moved in over 3 days. It may be stuck.
• Neglected — The project this task belongs to hasn't had any completions in 5+ days. The whole project may need attention.
• Blocked — Something is preventing progress. The -5 penalty pushes blocked tasks down the list since you can't act on them right now.

What's excluded

The Radar only scores incomplete, non-dropped tasks. Tasks in the Done or Dropped columns are never shown.

Ghost Tasks

Ghost Detection finds the tasks you've been avoiding — the vaguely defined ones, the stale ones, and the ones that slipped backward — and prompts you to deal with them before they become dead weight.

A task becomes a ghost when it matches one or more of these criteria:

1. Stale — The task hasn't been modified in a while. For tasks in active columns, this means more than 7 days without a change. For tasks in queue or backlog columns, the threshold is 14 days (since these are expected to sit longer).

2. Vague — The task name is too short or lacks a clear action verb. "Taxes" is vague; "File tax return" is not. Flowcus uses a clarity scoring system to evaluate task names and flag those that are ambiguous.

3. Moved Backward — The task was moved from a later column to an earlier one in the last 30 days, signalling regression rather than progress.

4. Sparse — The task has no notes and no subtasks, and was created more than 3 days ago. New tasks get a grace period, but older tasks with no detail are worth reviewing.

Each criterion contributes to a severity score. Ghosts are visually highlighted on the board at two tiers:

• Low severity: The task matches one criterion (e.g. stale)
• High severity: The task matches multiple criteria (e.g. stale and vague)

Snoozing Ghosts

If a ghost is flagged but you're not ready to deal with it yet, you can snooze it. Right-click on a ghost task and choose "Snooze Ghost" to dismiss the ghost highlight temporarily. The task will reappear as a ghost after the snooze period expires.

The following tasks are never flagged as ghosts:

• Completed or dropped tasks
• Tasks deferred until a future date
• Snoozed tasks
• Tasks without a board position

Task History

Task History provides an audit trail of every state change for every task on your board. It records when tasks were created, moved between columns, blocked, unblocked, completed, and more.

Task History powers both Radar and Ghost Detection — giving those features the data they need to score tasks by momentum, detect regression, and identify neglect. You can view a task's full history in the Task Inspector to understand how it got to its current state.

Nothing hides in plain sight when you have a complete record of how your work has moved through your system.

WIP Gauge

The WIP (Work In Progress) Gauge helps you monitor and manage your workload by providing a visual indicator of your current work in progress levels.

Understanding the WIP Gauge

The WIP Gauge appears in the toolbar as a horizontal bar with color zones:

• Green: Work in progress is at a healthy level
• Amber: Work in progress is approaching your defined warning threshold
• Red: Work in progress has exceeded your maximum threshold

Keeping your WIP within appropriate limits helps:

• Improve focus by reducing context switching
• Increase throughput by limiting multitasking
• Identify bottlenecks in your workflow
• Maintain a sustainable workload

Per-Column WIP Limits

In addition to the global WIP Gauge, you can set WIP limits on individual columns. Click ... in a column header and set the maximum number of tasks allowed. When a column exceeds its limit, the header changes colour to alert you.

Configuring the WIP Gauge

1. Go to Settings → WIP Gauge
2. Enable the WIP Gauge toggle
3. Configure your thresholds:
   • Warning Threshold: When exceeded, the gauge turns amber
   • Maximum Threshold: When exceeded, the gauge turns red
4. Choose whether to include Queue columns in WIP calculations:
   • When enabled, tasks in Queue columns count toward your WIP
   • When disabled, only tasks in Active columns count toward your WIP

Troubleshooting

Permission Issues

OmniFocus Automation Permission

If Flowcus cannot access OmniFocus:

1. Go to System Settings → Privacy & Security → Automation
2. Ensure Flowcus is allowed to control OmniFocus
3. Restart both applications

Task Synchronisation Problems

Tasks Not Appearing

If tasks aren't appearing in Flowcus:

1. Check that the correct task source is enabled in Settings → Task Manager
2. Verify that OmniFocus or Things is running (if using their integration)
3. Check permissions as described above
4. Restart Flowcus

Changes Not Syncing Back

If changes in Flowcus aren't reflected in your task manager:

1. Check permissions
2. Verify that OmniFocus or Things is running
3. Try completing a different task to test synchronization
4. Restart both applications

Things Integration Issues

If Flowcus cannot communicate with Things:

1. Verify Things is running
2. Check that the Things integration is enabled in Settings → Sources
3. Verify your Things authentication token is correct in Settings → Sources
4. Restart both applications

Todoist Integration Issues

If Flowcus cannot communicate with Todoist:

1. Check that the Todoist integration is enabled in Settings → Sources
2. Verify you are signed in to your Todoist account
3. Check your internet connection (Todoist requires an active connection)
4. Try signing out and back in to Todoist in Settings → Sources

TaskPaper Integration Issues

If Flowcus cannot read your TaskPaper file:

1. Check that the TaskPaper integration is enabled in Settings → Sources
2. Verify the selected TaskPaper file still exists at the configured path
3. Ensure the file is not open in another application that may have locked it
4. Restart Flowcus

UI Issues

Task Cards Not Displaying Correctly

If task cards appear cut off or display incorrectly:

1. Adjust the zoom level using the zoom controls in the toolbar
2. Check if dynamic type settings are very large
3. Restart Flowcus

Common Error Messages

"Cannot Connect to OmniFocus"

This indicates Flowcus cannot communicate with OmniFocus:

1. Verify OmniFocus is running
2. Check automation permissions
3. Restart both applications

FAQ

See FAQ

Additional Support

For additional help, email support. You can also use "Contact Support" under the Help menu to send a bug report directly from the app.