Docs
Tracker Trapper documentation: how it works, Mac setup, the iPhone companion, privacy and FAQ.
Tracker Trapper is a small Mac menu-bar app that keeps your coding agents' checklists in sight. Agents such as Codex and Claude Code report what they started, finished, or got stuck on, and the menu bar shows it as one tidy list. Add the iPhone companion to carry the same list in your pocket.
How it worksPlans, tasks, runs and evidence, and how progress travels from your agent to your menu bar and phone.
Mac setupInstall the preview, connect Codex or Claude Code, and track a local list or a GitHub issue.
iPhone & widgetsJoin the beta, pair your phone, add Home Screen widgets and pick your notifications.
Privacy & dataWhat stays on your Mac, what Mobile sync uploads, and how long it is kept.
FAQ & troubleshootingPricing, compatibility, and fixes when progress, sync or notifications go quiet.
Quick start
- Install the Mac app. Download the preview, unzip it, move
TrackerTrapper.appto Applications and open it. A checklist icon appears in your menu bar. - Connect your agent. Open Settings → Setup, pick Codex or Claude Code, and choose Install / repair connection and skill.
- Start tracking. In your agent's conversation, type
/tracker on(Claude Code) or$tracker on(Codex). The agent's checklist appears in the menu bar as it works. - Optional: take it with you. Request iPhone beta access for widgets and notifications.
Early preview. Tracker Trapper is experimental software with limited testing. Keep backups and verify important work yourself. Report bugs on GitHub.