Getting started · Fluks Docs

Download the latest build from cdn.usefluks.com, open the disk image, and drag Fluks to your Applications folder. Launch it from Applications or Spotlight.

On first launch Fluks asks where your data should live. You have two options:

Create a new vault — new spaces live in a folder you own, ~/Documents/Fluks by default.
Link an existing vault — choose a folder that already contains a Fluks vault, for example one synced from another Mac or restored from a backup.

You can link more than one vault later from the vault switcher in the sidebar.

Choose New space, give it a name and an accent color, and open it. A space starts with an empty dashboard. Use the sidebar to turn panels on and off, and drag panel headers to rearrange the dashboard.

There are three quick ways to add a task on the Mac:

Press N while the Tasks panel is focused.
Use the capture row at the top of any task list.
Press ⌘⇧Space from anywhere on your Mac for system-wide Quick Capture.

The quick-add field understands natural language. Try:

Pay rent tomorrow 9am
Standup every weekday 9:30
Review the roadmap friday

Press Enter to add the task and keep the dialog open for the next one, or ⌘Enter to add it and close the dialog. The chips below the field let you set a destination space, schedule, goal, status, estimate, and tags without typing the syntax.

Open the Habits panel and choose New habit. Give it a name and pick a schedule: a number of times per day, specific weekdays, a weekly or monthly quota, or a lifecycle window. A simple habit is completed by tapping its checkbox; rules and smart habits are covered in Habits.

⌘K opens the command palette for navigation, creation, and logging.
? opens the keyboard shortcut sheet.
⌘B hides or shows the sidebar.
⌘J opens the floating AI chat.
⌘⇧D opens today’s daily note.

Install the Fluks build you received through TestFlight. iPhone builds are distributed through TestFlight while the app is in testing.

The iPhone app opens on a sign-in card. Create an account, verify your email, and sign in. If the account has two-factor authentication enabled, enter the code from your authenticator app.

The iPhone app currently requires an account to open. This is how it links to the vault you use on your Mac. The Mac app itself does not need an account for local-only use.

After sign-in, Fluks loads the local state already on the phone and then syncs with your account in the background. The sync badge in the app shows whether the vault is syncing, paused, offline, or up to date.

If this is your first device, create a space on the Mac first, or create one on the iPhone from the command sheet. To use an existing local-only Mac vault on your phone, sign in on the Mac and enable sync for that vault in Settings → Vault.

The iPhone app is organised as tabs: Time, Notes, Tasks, Habits, Goals, Measures, AI Chat, and Settings. You can hide and reorder sections from Settings → Panels.

The floating navigation pill opens the command sheet. From there you can:

create a note, task, goal, measure, or space;
jump to any section or space;
complete tasks that are due;
search notes, tasks, goals, measures, habits, and chats;
run Sync now;
change appearance and theme color.

Open Tasks, tap the add button, and type a title. Use the schedule control to add a due date, or type a natural-language phrase such as “tomorrow 9am” or “every Monday”. The iPhone task list groups tasks by due date and offers status filters; the full Open, Board, Table, Calendar, and History views are available on macOS.

Learn how tasks move through Open, Board, Table, Calendar, and History in Tasks.
Set up recurring habits, completion types, and reminders in Habits.
Understand what syncs and what stays on your device in Sync and privacy.