{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "michellzappa-headroom--approve-agent-requests-from-iphone",
 "repo": "michellzappa/headroom",
 "repo_url": "https://github.com/michellzappa/headroom",
 "repo_slug": "michellzappa-headroom",
 "title": "Approve or deny coding agent requests from your iPhone",
 "page_title": "How to approve or deny coding agent requests from your iPhone with Headroom",
 "summary": "Pair the iPhone app to your Mac so you can answer Claude or Codex requests when you are away from the desk.",
 "who": "A developer whose Claude or Codex session is waiting on a yes or no while they are away from the desk, on the same LAN or Tailscale as their Mac.",
 "problem": "A coding agent pauses on an approval or question, and you only find out hours later when you return to your Mac.",
 "outcome": "Pending agent requests appear in the iPhone Attention tab, and you can approve, deny, or reply from the phone. Headroom answers the request but does not start new work.",
 "steps": [
  "Install the Mac app and confirm the host is running with `curl -s localhost:8737/health | python3 -m json.tool`.",
  "Install the iPhone app from TestFlight when it is published, or build it from source using docs/ios-companion.md.",
  "In the Mac app, open Settings and copy the mobile token from iPhone pairing. Do not use the host token.",
  "On the iPhone, pair with the Mac using the mobile token, then open the Attention tab.",
  "Check the pending request, then approve, deny, or reply. Confirm the agent resumes on the Mac."
 ],
 "agent_prompt": "Using the michellzappa/headroom repo, pair the Headroom iPhone companion with my Mac using the mobile token from Mac Settings. Expected output: a pending <agent name> request appears in the iPhone Attention tab and can be answered. Verify by confirming the request is listed on the phone and the Mac host responds to `curl -s localhost:8737/health | python3 -m json.tool`.",
 "agents": [
  "claude-code",
  "codex",
  "cursor"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The README says the iPhone companion needs the same LAN or Tailscale as the Mac and uses a mobile token, not the host token; it is not a cloud service.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "macOS 14 or later for the menu bar app",
  "Python 3.9 or later (the bundled host is stdlib only, using /usr/bin/python3)",
  "At least one AI coding tool already signed in locally",
  "Optional: iPhone or iPad on iOS 17 or later, on the same LAN or Tailscale as the Mac",
  "Optional: PlatformIO and a Waveshare ESP32-S3-Touch-AMOLED-1.8 for the desk board"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The iPhone is given access to approve or deny agent requests, so keep the mobile token private and do not use the host token on the phone."
  }
 ],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/michellzappa-headroom/approve-agent-requests-from-iphone/",
 "md": "https://dedupedai.com/use-cases/michellzappa-headroom/approve-agent-requests-from-iphone/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/michellzappa-headroom--approve-agent-requests-from-iphone.json",
 "api_version": "v1"
}