FAQ and troubleshooting

The Mac app is free. The iPhone companion (app, Home Screen widgets, push notifications and relay sync) will be $2.99/month or $24/year at launch. It's free during the invite-only TestFlight beta, and no payment is taken. See pricing.

Codex and Claude Code, through the local MCP server, the tracker skill and the command-line tool. Other tools that can call a local MCP server or run a command can report too, but they aren't set up for you.

No. Tracking starts when you ask for it (/tracker on or $tracker on), or when your agent is told to report on an issue. Connecting the MCP server makes the tools available, but your agent still needs the reporting instruction.

No. Local plans need no repository or account. GitHub is only needed to import and sync issue checklists.

The preview is built and tested for Apple silicon on macOS 13 or later. Intel support isn't verified.

No. The companion is iPhone-only for now.

No. It's read-only. It shows progress and alerts you, and it never edits tasks or approves agent actions.

Tracker Trapper lives in the menu bar and has no Dock icon. Look for the checklist icon, or press ⌘⇧T. If the shortcut does nothing, another app may be using it; change it in Settings → General.

Build 3 is signed and notarized, so macOS should only ask you to confirm the first launch. If you have an older preview build, which wasn't notarized, download build 3 again. As a last resort for an old build, open System Settings → Privacy & Security and choose Open Anyway.

In Settings → Setup, choose Install / repair connection and skill, restart or reconnect your agent, and run Create reporting test. Make sure the agent received the reporting instruction or ran /tracker on. Agent sessions that were already open keep using an older helper until they reconnect.

Only checklist lines with a bold stable ID and an em dash are imported, like - [ ] **TT-01 — Do the thing.**. Plain checkboxes are ignored.

Syncing to GitHub is an explicit step. Preview it, then run it. A pending-sync count reaching zero isn't proof that every issue was updated, so check the issue itself.

Check that your Mac is awake, online and has Mobile sync turned on. Then open the app or pull to refresh. The app shows separately when your Mac last shared and when the phone last checked.

The phone shows your Mac's Active plans. A plan leaves when no agent has worked on it recently, and finished plans leave a while after they finish. Disappearing never means the work was completed; the plan stays on your Mac.

Widgets show the phone's last successful sync. iOS decides when widgets redraw and background refresh runs. Open the app to refresh, and check that Background App Refresh is on in iOS Settings.

Check iOS Settings → Notifications → Tracker Trapper first, then the app's own notification settings. Completion alerts are off by default. Waiting and blocked alerts are on, but they only fire when an agent actually asks you something; an agent that stops without asking stays quiet.

Mobile sync needs Mac preview build 3 or later, plus the one-time Terminal setup in Pair your iPhone. Use the same invited email on your Mac and your phone.

Codes expire after two minutes and work once. Make a new one from Settings → Companion on your Mac.