📦 PocketAgent
Your own always-on AI agent that lives on your Mac and works for you over text. No app. No browser tab. You just text it like a person — it reads, thinks, does the work, and texts you back.
⬇ Download the kit (16 KB)
Then follow the setup guide below — about 10 minutes start to finish.
What it actually does
It's Claude — the same AI engineers use to write code all day — wired into your iMessage, running 24/7 on your Mac with real hands on the machine. Text it and it can:
- Answer and research anything — send a question, a link, an article. It reads the actual thing and gives you the straight answer.
- Do real computer work — write and fix documents, organize files, dig through folders, build spreadsheets, draft emails you copy-paste and send.
- Remember everything you tell it — "remember my garage code is 4411", "my rate is $95/hr". It keeps a memory file and uses it forever after.
- Keep your list — it maintains a priority board of what you've got going and where things stand.
- Stay alive on its own — a watchdog checks it every 60 seconds and revives it if it ever dies. Text
!status for a health check, !restart to reboot it from your phone.
Locked to you. Only YOUR phone number can talk to it. It never posts, sends, or publishes anything anywhere without your explicit go. Everything it learns stays in plain files on your Mac — no cloud accounts, no API keys.
What you need
| Thing | Why |
|---|
| A Mac that stays on | The agent lives on it (iMessage is Mac-only) |
| An iPhone with iMessage | That's how you talk to it |
| Claude subscription — Pro, $20/mo (claude.ai) | The AI brain. Your own account, your own login |
A Mac mini in a closet is the classic move — it just needs power, wifi, and Messages signed in to your Apple ID.
Setup guide (10 minutes)
Step 1 — Sign your Mac into Messages.
Open the Messages app on the Mac → Settings → iMessage → sign in with the same Apple ID as your iPhone. Send yourself a test text from the Mac to confirm it works.
Step 2 — Download and run the installer.
Download the kit, double-click the zip to unzip it, then open Terminal (⌘-space, type "terminal") and run:
cd ~/Downloads/pocket-agent-kit && bash install.sh
It asks your first name and phone number, installs everything (including Claude Code if you don't have it), and locks the agent to your number.
Step 3 — Give it permission to read your texts.
System Settings → Privacy & Security → Full Disk Access → turn ON Terminal. This is what lets the agent see the messages you send it. One time, done forever.
Step 4 — Log in Claude.
In Terminal run claude, type /login, and finish the sign-in in the browser with your Claude account. Then press ctrl-c twice to exit.
Step 5 — Start it.
Double-click StartAgent.command in the PocketAgent folder in your home directory. A terminal window opens — that's your agent, alive. It also auto-starts every time the Mac boots from now on.
Step 6 — Text it.
From your iPhone, text yourself: "you alive?" — it replies in that same thread. If it asks about pairing the first time, type /imessage:access in the agent's terminal window and approve your number. That's it — you have an agent.
If something's off
- No reply? Text
!status. Still silent → on the Mac, double-click StartAgent.command again.
- "FDA DENIED" in the terminal → redo Step 3, then restart the agent.
- It says it's logged out → redo Step 4.
- The watchdog texts you automatically if it ever goes down and revives it — most problems fix themselves within a minute.
Add-on packs
This download is the full-run edition — the installer sets up all six packs for you (it asks once, hit enter). Here's what they do:
🎙 Voice PackSend voice memos instead of typing — the agent transcribes and acts on them. Rambling in the truck becomes a to-do list.
🔗 Content Vetting PackSend it Instagram reels, TikToks, YouTube videos — it pulls the actual transcript and on-screen text and tells you straight: real, hyped, or garbage.
☀️ Morning Brief PackA daily 7am text with your day: priorities, weather, reminders, whatever you feed it. Your agent, but proactive.
🏋️ Coach PackText it every meal and workout — it logs everything, tracks protein/calories against your targets, programs your lifts, and nags you when you slack.
📈 Market Desk PackAn overnight research desk: it vets stock tips you send it, tracks a paper portfolio, and briefs you before the open. Research only — it never trades your money.
🛠 Business PackEstimates, invoices, client message drafting in your voice, job tracking — for anyone running their own operation from their phone.
FAQ
Is my stuff private? Yes. Memory, logs, and files live on your Mac. The AI processing happens through your own Claude account, same as using claude.ai directly.
What's the total cost? The Claude subscription ($20/mo Pro). The kit itself has no service fees — nothing else to subscribe to.
Can other people text my agent? No — it only answers your number. Anyone else who texts the Mac gets ignored, and if they ask it for access it refuses and tells you.
How do I remove it? One command, listed in the README inside the kit. Your Mac and Claude account are untouched.
⬇ Download the kit
Runs on your hardware, your accounts, your rules.