Help & FAQ

A pomodoro timer and a task list in one place. You work in focus sessions with breaks in between, on a short list of what you plan to get done today, picked from everything else you have to do.

The timer lives on the Focus page. It has three intervals: a focus session, a short break and a long break. After each focus session Pomonaut moves you to a break — a long one after every fifth session, a short one otherwise — and after a break back to a focus session.

Stop drops the session or break under way and starts the count towards the long break over. Sessions you have already finished still count for their tasks.

Yes, in Settings → Sessions under Timer: Sessions, Short Break and Long Break, each from 1 to 99 minutes. They start at 25, 5 and 15 minutes. The long break always comes after five focus sessions; that number cannot be changed. A timer waiting at the start of an interval takes its new length at once, on every device; one already running or paused part-way keeps its time, and the new length applies from the next interval.

Turn on Auto-start sessions in Settings → Sessions. A break then starts by itself after each focus session, and the next focus session after each short break, until the cycle of five sessions ends with the long break. After the long break you start the next cycle yourself. It is off by default.

Yes. The running timer is saved to your account, not to the browser tab, so it carries on across reloads, other tabs and any other device you are signed in on. When an interval ends, only one of them records it.

In Settings → Sessions under Notifications, pick a sound and press Preview to hear it. Breaks use the same sound pitched lower, so you can tell the two apart without looking. The sound is generated in your browser.

Repeat until I react plays it again every 5 seconds until you start or pause the next interval, and stops on its own after about two minutes. With auto-start on it has no effect, since the next interval begins by itself.

The Focus page shows the timer and only the tasks you plan to work on today. Once a day, on your first visit, Pomonaut adds every open task that is due today or overdue, and takes off the ones you finished on an earlier day. Unfinished tasks stay on for the next day. A new task joins the list when it is due today or earlier, or when you add it from the Focus page.

To add or remove a task yourself, use the button on its row; its open subtasks come along. The ⋮ menu on the Focus page has Add to focus (pick from overdue, today, upcoming or undated tasks), Add today to focus and Clear completed. Taking a task off shows a toast with Undo, which puts it back, under the timer too if it was there. A task you take off stays off until the next day.

Clear completed there only takes finished tasks off today's list. They stay on your task list, done; nothing is deleted.

Click a task on the Focus page to make it the one you are working on. It is shown under the timer, and every focus session you finish is counted towards it. One task is under the timer at a time.

With Focus Mode on in Settings → Sessions, the Focus page shows only the timer and the task you are on while a focus session runs. Press N to note a stray thought as a task without leaving it.

They are the views in the sidebar of the Tasks page, which opens on Today:

• Inbox — Tasks that are not filed under a project.
• Today — Due today, plus anything overdue.
• Upcoming — Everything due after today, soonest first.
• All tasks — Every task you have, dated or not.

Under them are your projects and the filters for project, label and priority.

It is ticked off, and a toast with Undo appears for a few seconds; the same goes for reopening and deleting a task. On the Tasks page and project pages, finished tasks are hidden; showing them again with Show completed tasks is Premium.

Three switches in Settings → Tasks change what happens next. All three are off by default:

• Auto-remove completed tasks removes a task from your list as soon as it is done. This can't be undone. Repeating tasks are never removed.
• Select the next task automatically puts the next open task under the timer when you complete the one you are working on.
• Keep repeating tasks in focus keeps a repeating task as your current task after it moves on to its next date.

On the Tasks and Focus pages, while you are not typing in a field:

• S Start or pause the timer
• F Switch to a focus session
• B Switch to a short break
• L Switch to a long break
• N Add a task

Signed in, the menu's Shortcuts page lists them with more detail.

Type it into the add box the way you would say it, such as Water the plants tomorrow at 5pm p1 #Errands @home. Pomonaut picks out the parts it recognises, highlights them as you type, and keeps the rest as the title. While you type, # suggests your projects, @ your labels and { a few deadlines.

• A day

  EN todaytomorrowday after tomorrow
  DE heutemorgenübermorgen

• A weekday

  EN frifridaynext monday
  DE frFreitagnächsten Montag

  A weekday on its own is the next one coming; “next” adds a week.

• A date

  EN 27.1.jan 273/4
  DE 27.1.27. Januar

  “3/4” is month/day — 4 March — and is read in English only.

• From today

  EN in 3 daysnext weekweekend
  DE in 3 Tagennächste Wochewochenende

  “Next week” is the coming Monday; the weekend is the coming Saturday.

• End of …

  EN eodeoweom
  DE tagesendeeowmonatsende

  End of today, of the working week (Friday) and of the month.

• A time

  EN 5pm17:00tomorrow at 5pmtomorrow evening
  DE 17 Uhr17:00morgen um 17 Uhrmorgen früh

  A time without a day means today, even if it has already passed.

• Priority

  EN p1p2p3p4!1
  DE p1p2p3p4!1

• Project

  EN #Errands
  DE #Errands

  Only an existing project is picked up, spaces in its name included; an unknown name stays in the title.

• Label

  EN @shopping
  DE @einkauf

• Deadline

  EN {fri}{27.1.}
  DE {fr}{27.1.}

• Estimate

  EN for 45mfor 2 hours
  DE für 45mfür 2 Stunden

  The task's estimate, up to a day.

• Repeat

  EN every mondayevery other weekevery 3rd fridayevery last dayevery workdayevery day at 9am
  DE jeden Montagjeden zweiten Montagjeden 3. Freitagjeden letzten Freitagwerktagsjeden Tag um 17 Uhr

• Repeat from completion

  EN every! 3 days
  DE alle! 3 Tage

  With “!”, the next date counts from the day you complete the task, not from its due date.

• Description

  EN // call first
  DE // erst anrufen

  Everything after “//” becomes the description.

To keep a word in the title that would otherwise be read as a date, put it in quotes or start it with a backslash, as in Read "tomorrow" again. Text pasted from Todoist loses its /section and +person parts, since Pomonaut has nothing to file them under.

Yes. Pick English or Deutsch under Quick add in Settings → Account. It decides which words the add box reads; the rest of Pomonaut stays in English. The same form has your Time zone, which decides which day “today” and “tomorrow” mean and when a task counts as overdue.

Priority 1 is the most urgent and priority 4 the least. In quick-add, type the token on its own:

• Priority 1p1
• Priority 2p2
• Priority 3p3
• Priority 4p4

Priority 4 looks the same as no priority. !1 to !4 work too.

A label is a word you attach to a task, typed with @ in quick-add or picked in the task form. There is nothing to set up first: a new word becomes a new label. A task can carry up to 20.

Each label gets a colour from its name until you pick one: in the Labels part of the Tasks page sidebar, use the swatch next to a label. The star next to a label or project pins it to Favorites at the top of the sidebar.

The due date is when you plan to work on a task, with a time if you like; it decides when the task shows up on Today and on your focus list. The deadline is when it has to be done. It is a date without a time, written in braces in quick-add, like {fri}, which is Friday. Its flag badge turns red once the day has passed.

How long you expect a task to take, from a minute up to a day. A new task starts at one session of your own length; the task form's − and + change it in steps from 5 minutes up to a day, and in quick-add for 45m sets it to exactly that. Each task shows the time you have focused on it next to its estimate, counted as the sessions you finished at your session length, so you can see when a task takes longer than planned.

Give a task a repeat rule in quick-add or in its Repeat field, which reads the same words and also has a picker for the common rules. When you complete a repeating task it is not finished: it moves on to its next date and its session count starts over. The toast says when it is next due, and Undo puts it back.

• Completing it early does not skip ahead: the next date follows the current due date.
• An overdue task jumps to the first date after today, so catching up on a daily task takes one tick, not seven.
• A rule with !, like every! 3 days, counts from the day you complete it.

Use the button on a task's row to add one under it, or open the task and type into the Add subtask line under its subtasks: Enter adds it and leaves the line ready for the next one. Both take the same shortcuts as adding a task, except #: a subtask goes into its parent's project. Subtasks nest up to four levels below a top-level task, and always show under their parent.

To move an existing task in or out:

• On a list, drag the grip to the right to make the task a subtask of the one above it, or to the left to move it out of its parent. With the grip focused, → and ← do the same.
• From a task's ⋮ menu, on a list, a board card or a calendar day, Make subtask of puts it under the task above it, and Move out of moves it one level up. On a board the menu is the quick way, since dragging a card there only moves it between columns.
• Anywhere, open the task, choose Edit and pick its parent, or No parent.

A task cannot go under one of its own subtasks, and a task synced with Todoist only under another Todoist task. A subtask moves into its parent's project, with its own subtasks; moving it out keeps the project.

Click a task to open it: its dates, labels, project and estimate, the whole description, its parent and its subtasks, which you can tick off or add to right there. Edit changes it in the same window. On the Focus page a click on a task puts it under the timer instead, so there you open it with its pen, which shows the form; Cancel leaves the task open.

While a task is open, the address in your browser points at it, and Copy link, there or in the task's ⋮ menu, copies a link to the task's own page. A link only opens the task for someone who can see it: you, and the members of the shared project it is in.

Yes. Open the task and write under Comments, below its subtasks, then press Comment (or ⌘/Ctrl+Enter). A comment takes the same formatting as a description, up to 2,000 characters, and shows who wrote it and when. Comments are free on every plan.

Everyone who can see a task reads its comments and can add one: on a task of your own they are notes to yourself, in a shared project everyone in it sees them. You can edit and delete your own comments; an edited one says so. The owner of a shared project can also delete anyone's comment on its tasks. Someone who leaves the project keeps their comments there.

A removed task keeps its comments, but they can no longer be added to, edited or deleted. A comment is deleted with the account of the person who wrote it, and with the account that owns its task.

The icon in the header opens search. It finds tasks whose title, description, project or labels contain what you type, and you can narrow it by project, labels and priority. Results are ordinary task rows, so you can open and edit one without leaving the search.

Searching your open tasks is free. Premium adds finished tasks and the ones you have cleared or deleted, and a calendar view that lays the results out by due date, deadline and coming repeats.

Yes. Under Autolink references in Settings → Tasks, add a prefix such as JIRA- and an address with <num> where the number goes. Matching text in task titles and descriptions then becomes a link. Choose Numeric when the references look like JIRA-123, Alphanumeric when they look like JIRA-a1b2.

Projects are part of Premium. Create one with Add Project on the Projects page, give it one of the colours, and file tasks under it with the project picker or with #Name in quick-add. Tasks with no project are in the Inbox.

Deleting a project keeps its tasks.

On the project's page, open People in this project, type an email address and press Invite. The person gets an invitation by email. Everyone in the project sees and changes its tasks and can be assigned to them, and sees the name and email address of every other member.

A project holds up to 25 people, counting you as the owner and every invitation still pending. Sharing needs Premium on the owner's account only: the people you invite can join on any plan, including a free account.

A project that comes from Todoist cannot be shared here; share it in Todoist instead.

Open the link in the invitation email and choose Join project. You have to be signed in with an account whose confirmed email address is the one the invitation was sent to; if you have no account yet, create one with that address first. Invitations expire after 14 days, and the owner can withdraw one before then.

Only the owner renames, recolours or deletes a project, invites or removes people, and changes the columns of its board. A member can leave with Leave project. The owner cannot leave their own project; they delete it instead.

When someone leaves or is removed, their tasks stay in the project, and whatever was assigned to them becomes unassigned.

Its assignee. A shared task's place on the focus list and under the timer belong to the person it is assigned to. Putting an unassigned task on your focus list, or starting the timer on it, assigns it to you.

Yes, in every browser where you turned on notifications: when someone else comments on a task in a project you own or are a member of, you get a notification with their name, the task and the start of the comment, and clicking it opens the task. Your own comments and edited comments notify nobody, and comments are never sent by email.

To stop them, turn off Notify me about comments in Settings → Tasks.

The one you set under Your name in Settings → Account. Left empty, they see the part of your email address before the @.

Yes. A project page switches between List, Calendar and Board, and remembers for each person which one they used last on that project. The Tasks page offers the calendar too when you filter it by labels, with Premium.

No. A board column is a place, not a status: only ticking a task off completes it, so the board and the list never disagree about what is open.

A new board starts with To do, In progress and Done. It can have up to 7 columns, with names of up to 40 characters. The owner adds, renames, reorders and deletes them; deleting one moves its tasks to the first column, and the last column cannot be deleted. Everyone in the project can move cards.

Yes, under Calendars in Settings → Integrations. Paste the secret iCal/ICS address of a calendar — from Apple iCloud, Outlook, Nextcloud, Fastmail or anywhere else that offers one — or, with Premium, connect Google Calendar and pick calendars from it. Today's entries then appear next to the timer.

A free account can add 2 calendars and Premium up to 10, Google calendars included. Pomonaut only ever reads them, and your entries are never stored on our servers.

Pomonaut asks Google only whether you are free or busy, never what an entry is called — it is the narrowest access Google offers, and it cannot change anything. If you would rather see titles, add that calendar's iCal/ICS address instead.

Pomonaut warns you when the session or break you are about to run would run into something on your calendar. It is only a warning; the timer starts as usual. Only entries that mark you busy count — free time, declined and cancelled entries are ignored, and so are all-day entries.

Yes. Under Share your calendar in Settings → Integrations, Create link publishes your open tasks' due dates, deadlines and repeat rules as a private, read-only link any calendar app can subscribe to. It includes tasks from projects shared with you.

Anyone with the link can see those tasks' titles, descriptions and dates, so keep it as private as a password. Regenerate replaces it and Revoke turns it off; calendar apps using the old link stop updating. With Premium, a project's owner can also give that one project its own link from the project page.

A task can remind you before its due date and before its deadline. New tasks start with the reminders set under Reminders in Settings → Tasks, one each for Tasks with a time, Tasks due on a day and Deadlines. Out of the box that is 15 minutes before a task with a time, and 09:00 on the day for a task due on a day and for a deadline. Changing them affects new tasks only.

Yes, in its form, next to the date it belongs to: a reminder needs a due date or a deadline to count back from. Before a due time you can pick at time of task, 5 minutes before, 10 minutes before, 15 minutes before, 30 minutes before, 1 hour before, 2 hours before, 1 day before. For a day or a deadline you can pick on the day, 1 day before, 2 days before, 1 week before, at a time of day you choose.

Reminders go only for open tasks. On a shared project, the person the task is assigned to gets them. A reminder that could not go out within 15 minutes of its time is skipped rather than sent late. A reminder whose time had already passed when you set it is not sent at all: a task added at 11:00 and due today, with a reminder at 09:00, stays quiet, and so does a task with a time added less than its reminder ahead of it.

Under Reminders in Settings → Tasks, press Turn on next to Notifications in this browser and allow notifications when the browser asks. Reminders then show up even while Pomonaut is closed. Do this in each browser you want them in. If the browser has blocked Pomonaut, allow notifications in its site settings first.

Reminders are notifications only; they are not sent by email. The same notifications tell you about new comments on shared tasks.

Connecting Todoist is part of Premium: Connect next to Todoist in Settings → Integrations. Then the ⋮ menu above your task list has Import from Todoist, to pick tasks, and Import today from Todoist. Tasks come over with their due dates, deadlines, labels, subtasks, repeat rules and durations, which become their estimates; tasks assigned to someone else are skipped, and a subtask never comes without its parent.

After that both sides stay in step. Completing, editing, moving or deleting a linked task here does the same on Todoist, and changes made on Todoist are picked up whenever a focus session finishes or you pause the timer. A label Todoist does not have yet is created there. A task's estimate is its duration on Todoist: changing one changes the other, and a task without a duration on Todoist keeps the estimate it has here.

A repeat rule Pomonaut cannot read is kept as Todoist's own words (the Repeat field says Set in Todoist), and Todoist decides its next date. If your Todoist plan has no deadlines, a deadline stays on Pomonaut's side only.

No, never. Only your own projects sync with Todoist, so a task synced with Todoist cannot be moved into a shared project, and a project that comes from Todoist is shared in Todoist rather than here.

With Premium, Connect next to Spotify in Settings → Integrations. Your music then resumes when a focus session starts and pauses when you pause or a break begins. It plays on whichever device Spotify is open on, so open Spotify first. The Spotify button next to the timer turns this off and on again without disconnecting.

No. Disconnecting Todoist, Spotify or Google Calendar, removing a sign-in method and revoking an app never need Premium. Without Premium, a connection that is still stored shows Connected · paused without Premium and is simply not used.

Yes: Pomonaut for Home Assistant brings your focus list, Inbox and projects into Home Assistant as to-do lists, and the timer as sensors and buttons you can automate. Its page explains how to install it. You connect it by signing in to Pomonaut and approving it on the consent screen, which marks it as a self-registered app; that is expected.

Yes, and both are free. An MCP server lets Claude and other assistants that speak the Model Context Protocol read your list and run your timer, and a JSON API does the same for scripts and integrations. Every app signs in through Pomonaut and asks you to approve it on a consent screen. For your own scripts, create a personal access token in Settings → Security; it is shown once, so copy it right away. Features that need Premium in the app need it there too.

The developer reference has the details.

Every app you approved and every personal access token is listed under Connected apps & devices in Settings → Security. Revoke ends its access at once. Changing or resetting your password, and resetting two-factor authentication, revoke them as well.

Check your spam folder first. The link in it is valid for 24 hours. On the sign-in page, Didn't get a confirmation email? Resend it sends a new one.

Under Email address in Settings → Account. You confirm the change through your current inbox, then through the new one.

Under Password in Settings → Security. The new password takes effect once you confirm it through the link we email you, and confirming signs you out everywhere, connected apps included.

Forgot it? Use Forgot your password? on the sign-in page. The reset link is valid for one hour. Resetting your password also turns off two-factor authentication and signs you out everywhere.

It is optional. Under Two-factor authentication in Settings → Security, choose Set up two-factor authentication, scan the code with an authenticator app and enter the 6-digit code it shows. You get 10 backup codes, shown once: each works one time, in place of a code from the app, when you choose Use a backup code instead while signing in.

Your other open sessions are asked for a code too, except those signed in with a passkey. To turn it off, confirm with your password (or a code, if your account has no password); that signs out your other sessions. For a fresh set of backup codes, turn it off and set it up again.

On the two-factor step of signing in, choose Lost your device or backup codes? Reset two-factor authentication, confirm your email address and password, and we email you a reset link. It is valid for one hour and works once. It turns two-factor authentication off and signs you out everywhere, so you can sign in with your password and set it up again. Resetting your password does the same.

Yes. If an account already exists with the email address Google or GitHub vouches for, signing in links to it. Two-factor authentication still applies. Under Sign-in methods in Settings → Security you can connect and disconnect them, except for the last way you have left to sign in. Pomonaut keeps no access token from either.

Yes. A passkey signs you in with your fingerprint, face or device PIN instead of a password. Under Passkeys in Settings → Security, choose Add a passkey, confirm with your password (or an authenticator code, if your account has no password) and follow your browser's prompt. We email you whenever one is added.

To sign in, choose Sign in with a passkey on the sign-in page, or pick the passkey your browser suggests in the email field. A passkey counts as both factors, so signing in with one skips the two-factor step. You can remove passkeys in the same place, except the last way you have left to sign in. Pomonaut keeps only the passkey's public key; your fingerprint, face and PIN never leave your device.

Yes, under Password in Settings → Security; the link we email you confirms it. Some changes, such as deleting your account, ask for your password or an authenticator code, so an account with neither has to add one of them first.

Choose Export data under Your Data in Settings → Account. We email you a link once the zip of CSV files is ready — your tasks, projects, focus sessions, calendar subscriptions and the rest of your account — and the link expires after 7 days. Passwords and access tokens are left out. One export can be in progress at a time.

Under Delete account in Settings → Account, confirm with your password (or an authenticator code if your account has no password). It permanently deletes your account with all its tasks, projects and focus session history, including the projects you shared with others, and cannot be undone. Tasks you added to someone else's shared project stay there.

The privacy policy explains what data is kept, for how long, and your rights.

Projects, the Todoist sync, Spotify control and Reports, and with them:

• searching finished, cleared and deleted tasks, and the search calendar,
• showing completed tasks again on the Tasks page and project pages,
• sharing projects, and a calendar link of a project's own,
• connecting Google Calendar, and up to 10 calendars instead of 2.

The timer, tasks and their repeat rules, focus mode, reminders, searching your open tasks, the calendar link for all your tasks, the API and MCP, and your data export work on every account.

Confirming your email address gives your account Premium, and so does signing up with Google or GitHub. There is nothing else to do: Premium is free on every confirmed account, for now.

Your total focus time, completion rate, streak and more, focus time per day and per project, and the hours of the day you get work done — over the last 7, 30 or 90 days or all time, with a CSV download. Focus sessions older than about three months are deleted, so that is as far back as Reports go.

Nothing is deleted. Your projects and your Todoist and Spotify connections are kept, just not used, until Premium is back. A project you shared stays shared, but you cannot invite anyone new.