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

Calendar Issues

Calendar access (macOS Calendar)

Blueprint's calendar lane reads events from the Calendar app on your Mac through Apple's EventKit, so it relies on a macOS permission. If Flowcus reports a problem with that permission, here's what each state means and how to fix it:

  • Access denied — you declined the permission prompt, or turned it off later. Open System Settings → Privacy & Security → Calendars, enable Flowcus, then quit and relaunch Flowcus.
  • Read access required — Flowcus was given add-only access, which lets an app create events but not read them. Blueprint needs to read your events, so change the setting to full access in the same place, then relaunch.
  • Access restricted — calendar access is blocked by a system policy such as parental controls or an MDM profile, so it can't be changed from Flowcus. Speak to whoever manages the Mac.
  • Not available — macOS Calendar integration needs macOS 14 or later. On macOS 13 you can connect Google Calendar instead.

Removing a macOS Calendar account in Settings › Calendar hides its calendars from Blueprint but leaves the permission itself in place — revoke it from System Settings if you want it gone entirely.

Google Calendar

If events from Google Calendar stop appearing, or you see a sign-in error:

  1. Open Settings › Calendar and remove the Google account — this also deletes the stored tokens from your Keychain
  2. Add it again and sign in with Google when prompted
  3. Check your internet connection — Google Calendar events can only refresh while you're online

To revoke Flowcus's access from the Google side, visit myaccount.google.com/permissions and remove Flowcus. Access is read-only, so nothing in your calendar is affected either way.

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

Feedback

Wrong or awkward translation

If something in Spanish, Italian or Simplified Chinese reads wrong, choose Help › Send Feedback… and open the Translation tab. Paste the text as Flowcus shows it and what it should say — that's all we need to fix it in a future update.

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