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

Full Disk Access

Flowcus reads your OmniFocus database directly to fetch tasks and build the Projects view. macOS protects that database behind Full Disk Access, which is separate from the Automation permission you grant when first connecting OmniFocus. If you see "Couldn't read project stats," Flowcus most likely hasn't been granted Full Disk Access yet.

To fix it:

  1. Open System Settings → Privacy & Security → Full Disk Access.
  2. Find Flowcus in the list and turn it on. If it isn't listed, click +, then add Flowcus from your Applications folder.
  3. Quit Flowcus completely and reopen it (macOS only applies the new permission on restart).
  4. Open the Projects view again.

Why two permissions? Automation lets Flowcus make changes in OmniFocus (completing and flagging tasks). Full Disk Access lets it read OmniFocus's database quickly to power the Projects view and fast startup.

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
  5. If using OmniFocus and the data looks stale, try switching Fetch speed to Via OmniFocus in Settings → Sources (see OmniFocus Fetch Speed)

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

"Couldn't read project stats"

This appears in the Projects view when Flowcus hasn't been granted Full Disk Access, which it needs to read the OmniFocus database. See Full Disk Access (OmniFocus Projects view) above for the fix.

Advanced Features