← Jupiter Optimus

Support

Jupiter Optimus for iPhone, iPad, Mac and Apple Watch

Need a hand, found a bug, or want to suggest a feature? Email [email protected] and you'll hear back from a human. Telling us your device and app version (Settings → About) helps us answer faster.

Looking for how-tos instead? The guides cover GitHub issues, the AI assistant, switching from Todoist or TickTick, and start dates. New in 1.6: creating issues from tasks, labels that set priority, statistics you can share and the Inbox section for undecided project work. From 1.5: the vault, widgets and the weekly review.

Subscription and billing

Jupiter Optimus is $9.99 per year with a 7-day free trial. There is no free tier and no additional purchases — every feature is included.

Your subscription is billed by Apple, so cancellations, refunds, and payment changes are handled in your Apple account: on iPhone or iPad open Settings → your name → Subscriptions; on Mac open App Store → your name → Account Settings. Cancelling during the trial means you are not charged. Refund requests go through reportaproblem.apple.com.

Already subscribed but the app doesn't recognise it? Open Settings → Restore Purchases while signed in with the same Apple Account you purchased with.

Moving in from another app

Open Settings → Data and pick your source:

Imports run in the background: a sheet shows how far along they are, and Cancel rolls the whole import back so nothing half-imported is left behind. A Reminders list named like one of your projects lands in that project rather than creating a second one.

The vault

Every project has a vault for short text you would rather not keep in plain view — an API key, a licence code, a door code. Open a project and choose Vault in the toolbar; it unlocks with Face ID, Touch ID or your device passcode and locks again after a few minutes or when the app goes to the background.

Items are encrypted on your device. The key is created the first time you unlock and kept in your iCloud Keychain, which is how your other devices open the same vault. If a device says the vault can't be opened there, check that iCloud Keychain is on for that device (Settings → your name → iCloud → Passwords & Keychain on iPhone; System Settings on the Mac), then try again. Backups carry vault items only in encrypted form, so a restore keeps them readable as long as the key is in your Keychain. We cannot read a vault or recover a lost key — that is the point of it.

Widgets

Any List shows the list you choose — a project, a smart list, Inbox, Today, Upcoming or Someday — in small, medium and large. Add it from the widget gallery, then long press it and choose Edit Widget to pick the list. This Week lays out overdue, today, tomorrow and the days after. Tap the circle in either widget to complete a task without opening the app. On the Mac both live in Notification Center and on the desktop. If a widget shows placeholder rows, open the app once so it can read your data.

Siri

With Apple Intelligence on iOS 27 or macOS 27, Siri can add and update your tasks. Say the app's name — “…in Jupiter Optimus”, or just “…in Jupiter” — so Siri doesn't reach for Apple Reminders. Your projects are lists (“Add milk to my Groceries list in Jupiter Optimus”), and due dates and times, repeats and flags (High priority) work too. To change a task, name it: “Mark Pay rent as completed in Jupiter Optimus”.

A few things to know. In the middle of a Siri conversation, “this” can mean the tasks Siri just made rather than the one on screen; start a new request to act on the task you have open. Location reminders aren't supported, so if Siri says it set one, the task was added without a place. Tapping a task in Siri's answer opens the app, not that task. A task you have only just created can take a moment before Siri finds it by name.

Choose Organize Sidebar at the bottom of the sidebar and drag spaces and projects into your order. On the Mac you can also drag projects in the sidebar, or right-click one and choose Move Up or Move Down. The arrow next to a space folds its projects away. The order syncs through iCloud; folding is kept on each device. In a project with sections, switch its sort to Manual to drag tasks within a section.

Weekly Review

Weekly Review in the sidebar walks you through the Inbox and every project's stale tasks — tasks left undated for two weeks — one card at a time: schedule, move, park for Someday, complete or delete, then a wrap-up with what you shipped this week. Every step is undoable, "Park all" and "Delete all" included, and the sidebar reminds you when a week has passed since the last one.

GitHub and GitLab

In Settings → Maximus you can connect a GitHub or GitLab account to import issues as tasks and, since 1.6, create issues from tasks. Your token is stored in the Keychain on your device and is used only to talk directly to that service. You can link a repository to a project, and optionally have an issue close when you complete its task — that write-back only ever happens after you turn it on. Creating an issue is always an explicit button press.

Connecting GitHub

The quickest route is Sign in with GitHub in Settings → Maximus: it shows you a short code, opens github.com so you can approve it, and finishes on its own when you come back to the app.

Prefer a token, or need one scoped to a single repository? Use a fine-grained personal access token:

  1. Open github.com/settings/personal-access-tokens/new.
  2. Under Repository access, choose the repositories you want to import from.
  3. Under Permissions → Repository permissions, set Issues to Read and write. Read-only is enough to import; write is what lets a completed task close its issue and lets a task create an issue.
  4. Add Pull requests: Read-only if you want pull-request notifications.
  5. Generate the token, copy it, and paste it into Settings → Maximus → Personal access token, then tap Connect.

A classic token works too — it needs the repo scope.

Connecting GitLab

GitLab connects with a personal access token. There is no one-tap sign-in, because GitLab only offers that to applications registered with your GitLab instance. Both gitlab.com and self-hosted GitLab work: enter your instance's address in the Server field when connecting (an instance behind a VPN needs the VPN active, and its TLS certificate must be one your device trusts — self-signed certificates are not supported).

  1. Open gitlab.com/-/user_settings/personal_access_tokens.
  2. Choose Generate token → Legacy token. GitLab also offers a fine-grained token, which limits access to chosen projects — a better idea in principle, but this version of the app can’t use one yet: it identifies your account through GitLab’s /user endpoint, which a project-scoped token cannot reach, so connecting would fail.
  3. Give the token a name and an expiry date.
  4. Tick api — and only that one. It covers reading issues and merge requests, closing an issue when you complete its task, and creating issues from tasks. If you only ever want to import and never write back, tick read_api instead. Everything else on that list — registry, runners, repository, Kubernetes — is unused by the app, so leave it unticked.
  5. Create the token and copy it — GitLab shows it only once.
  6. In Settings → Maximus, switch the provider to GitLab, paste the token, and tap Connect.

Importing issues

Once connected, add a repository as owner/repo (pasting its web address works too) and tap Import. Use the folder button on the repository row to send its issues into a specific project instead of the Inbox. Refresh All re-checks every repository at once.

If a connection stops working, the most common cause is an expired token — create a new one and paste it in again. Tokens are never synced between your devices, so each device needs its own.

Labels, milestones and priority

Imported issues bring their labels, milestone and assignees. Labels become tags, a milestone becomes a section in the project the repository maps to, and a few words set the task's priority: urgent, critical, blocker, p0 and p1 mean high; p2, high and important mean medium; low, minor, trivial, p3 and p4 mean low. A label matches when it contains one of the words as a word, so "priority: high" counts. Change the words per repository from the repository row: Priority labels → Edit.

A priority you set yourself stays until the labels on the issue actually change — a plain refresh never overrides your hand. The Review Queue marks draft pull requests and the ones where your review was requested.

Creating an issue from a task

Open a task that is not linked to an issue and tap Create issue on GitHub (or GitLab). Pick the repository — the one mapped to the task's project is preselected — keep or edit the title and description, and choose whether the task's tags are added as labels. The task links to the new issue, so Open, Close and Comment work as for an imported one. If the button is missing, either the task is already linked, or no repository is tracked yet. If the app reports it may not create issues, the token lacks Issues: Read and write (GitHub) or api (GitLab).

Statistics and sharing

The period menu at the top of Statistics switches between Today, This Week, This Month, This Year and All Time; completed, focus time, completion rate and active days follow it, with the change against the previous period. The choice is remembered. Share renders a square card with those numbers, your streak and top projects, and opens the system share sheet — send it, save it or post it. The card is drawn on your device; nothing leaves it except through the share sheet you open.

Inbox: unscheduled project tasks

Below the Inbox there is a second section, Unscheduled in projects: the active project tasks with no date and no start day ahead — the ones that still need a decision. The Inbox itself, its badge, the widget and the Weekly Review step are unchanged. Turn the section off in Settings → Lists.

The AI assistant (Maximus)

Maximus uses your API key with the provider you choose, so there is no subscription on top and no server of ours in the middle. Add a key in Settings → Maximus; remove it any time to disconnect. Nothing is sent anywhere until you give permission, and AI output can be wrong — check anything important before acting on it.

Anthropic, OpenAI and Google Gemini are one-tap choices. Custom (OpenAI-compatible) accepts any service that speaks the OpenAI chat-completions API — you supply the full endpoint address and the model name. That covers OpenRouter, Groq, Together, and similar. The address must be https://, except for a model server on your own device or local network (Ollama, LM Studio), which needs no key at all.

Backing up your data

Your tasks live in your own iCloud account and sync across your devices. On top of that, the app writes one backup a day to the Jupiter Optimus folder in your iCloud Drive and keeps the last seven — you will find it in Files on iPhone or iPad and in Finder on the Mac. It never runs while iCloud is still syncing, because a half backup is worse than none, and Settings tells you when the last one was written and what it holds. Turn it off there if you would rather it did not.

For a copy you place yourself, use Settings → Back Up All Data… to write a single file, and Restore from Backup… to bring it back. A backup carries your attachments, note images and link previews, and restoring merges rather than overwrites, so it is safe to run on a device that already has data.

Something not syncing?

Sync uses your private iCloud database. Check that the same Apple Account is signed in on both devices, that iCloud Drive is on, and that the device has a connection. Sync can take a moment to settle after a large import.

Privacy

We run no servers, use no analytics or tracking, and collect no personal data. The full details are in our Privacy Policy.

Contact

Email [email protected].

What’s new · Guides · Home