skills/imsg/SKILL.md
iMessage/SMS CLI for listing chats, history, watch, and sending.
npx skillsauth add Bitterbot-AI/bitterbot-desktop imsgInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use imsg to read and send Messages.app iMessage/SMS on macOS.
Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
sendchatId for history/watch (from imsg chats --limit 10 --json)text and optional file path for sendsimsg chats --limit 10 --json
imsg history --chat-id 1 --limit 20 --attachments --json
imsg watch --chat-id 1 --attachments
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
--service imessage|sms|auto controls delivery.imsg chats --limit 10 --json to discover chat ids.development
When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.
testing
Forces a memory_search before the agent sends a message containing a factual assertion that has not yet been grounded this turn. Closes the citation-rate gap from ~40% to ~90%+.
business
Enforces PROTOCOLS.md "stay quiet in group chats" deterministically. Blocks outbound messages in Discord/Telegram/Slack/etc group channels when the bot was not @mentioned and recently spoke.
development
When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident absolutes ("definitely", "always", "100%") in outgoing messages.