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
  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
Advanced Features