FILEFLOW

Support

Start small. Keep the plan in view.

A small first step. A workflow you can trust.

Your first three files

Start with a test folder

Use disposable sample files for your first run. Select a dedicated archive folder, then choose an existing structure with a destination folder or initialize a Johnny.Decimal template. Add a separate source folder. You can skip AI setup.

The manual workflow in 1.1

Open Inbox and scan. Select files, choose Archive to..., and select a destination. Inspect Review Plan, including source paths and conflict handling. Choose Execute to organize, or Back to leave without running the plan. Then inspect the results.

Working with suggestions

For items already in Review, change the destination as needed, then use Preview Selection to inspect the plan. Scanning alone does not guarantee that classified items appear in Review.

Connect an AI provider

In Settings, configure the provider endpoint, model, and matching protocol: OpenAI-compatible or Anthropic Messages. Supply your own authorized API key, verify the connection, then save. Ollama needs a separately running service and model. A connection test sends a synthetic filename; actual classification sends file metadata and candidate destinations.

Folder access and missing files

Check that the source and archive folders are accessible. Reauthorize a folder in Settings if macOS access has expired. For iCloud Drive locations, check that the files are downloaded. Avoid moving or renaming active source and archive folders during a run.

Interrupted operations and Undo

Read the reported results and recovery information before retrying. Do not delete recovery metadata to dismiss a warning. Eligible Undo may restore a file, retain an archive copy, use a Recovered location, or require manual action. It cannot reconstruct deleted contents or recover old overwritten contents.

Restore a purchase

Use the purchase restoration control in Settings while signed in to the Apple Account used for the purchase. Restore requires communication with the App Store. If the entitlement is not restored, note the displayed result and contact support.

Contact

Email fileflow@theunclej.com with your app version, macOS version, steps to reproduce, and the displayed error. Redact private paths and filenames from screenshots. Never send API keys or sensitive documents.

Back to FileFlow