Imsg
Apps & AutomationimsgImsg is an Agent Skill for apps & automation published in the Bitterbot-AI/bitterbot-desktop repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
iMessage/SMS CLI for listing chats, history, watch, and sending.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Bitterbot-AI/bitterbot-desktop/blob/HEAD/skills/imsg/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/imsg, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
imsg Actions
Overview
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.
Inputs to collect
- Recipient handle (phone/email) for
send chatIdfor history/watch (fromimsg chats --limit 10 --json)textand optionalfilepath for sends
Actions
List chats
imsg chats --limit 10 --json
Fetch chat history
imsg history --chat-id 1 --limit 20 --attachments --json
Watch a chat
imsg watch --chat-id 1 --attachments
Send a message
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
Notes
--service imessage|sms|autocontrols delivery.- Confirm recipient + message before sending.
Ideas to try
- Use
imsg chats --limit 10 --jsonto discover chat ids. - Watch a high-signal chat to stream incoming messages.