Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →ausboss/bluebubbles-relay
Read, search, send, react to, and attach images/stickers in iMessage via the BlueBubbles REST API.
Passed 16 of 20 test cases with the skill, and 10 of 20 without it.
and 5 more in the full report
7 fixed11 passed either way4 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
Download an attachment with GUID att-55443 using the CLI tool. I didn't specify an output directory path. Where will the file be saved by default?
| Checked | Without skill | With skill |
|---|---|---|
| Identifies the default download output directory as ~/Downloads/bluebubbles-relay/. | Missed | Passed |
The instructions your model reads when the skill loads.
This is a tool surface for an LLM agent that helps a user with their iMessages. The CLI wraps the local BlueBubbles REST API and returns a JSON envelope; you call it from your agent harness like any other command-line tool.
These have to be done by the human before the agent will be useful:
http://localhost:1234 (typically by SSH'ing to the Mac and running the CLI there).If your agent is already on the Mac with BlueBubbles:
./venv/bin/python messages_cli.py <subcommand>
If your agent runs elsewhere and SSHes in:
ssh <relay-host> "cd /path/to/bluebubbles-relay && ./venv/bin/python messages_cli.py <subcommand>"
All commands return a JSON envelope:
{ "success": true, "command": "...", "timestamp": "...", "result": "...", "details": { ... } }
Exit code is 0 on success and 1 on failure. Parse the envelope; don't rely on the exit code alone.
The CLI reads the BlueBubbles password at call-time from BlueBubbles' own config DB (~/Library/Application Support/bluebubbles-server/config.db) on the host it runs on. There is no copy of the password in the repo or in any env file. If the CLI runs on a different machine than the BlueBubbles server, BLUEBUBBLES_URL and BLUEBUBBLES_PASSWORD environment variables override the defaults.
| Command | Purpose |
|---|
test cases passed, vs 10 / 20 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.