← 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.

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:

GitHub and GitLab

In Settings → Maximus you can connect a GitHub or GitLab account to import issues as 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 — write-back only ever happens after you turn that on.

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.
  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 and closing an issue when you complete its task. 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.

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 and OpenAI 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 Google Gemini (via its OpenAI-compatible address), OpenRouter, Groq, Together, and similar. The address must be https://.

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].