Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

macos-cli — Self-describing macOS automation router — measured AI agent skill | DecimalAI

buddhayi/macos-cli

SkillScore96Maintained

Use macos-cli (binary `macli`) for any macOS-side automation — X/Twitter ops, WeChat send/read, native macOS apps + 492 KB AppleScript snippets, and 136 web-site adapters. Invoke whenever the user requests automation that runs on a Mac. The CLI is self-describing — query it for capabilities at runtime.

by buddhayi

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

DevOps & SRE pack

decimalai skills pull buddhayi-macos-cli

Get this skill — curl · raw file

curl -fsSL https://app.decimal.ai/s/buddhayi-macos-cli/SKILL.md

Raw file: /s/buddhayi-macos-cli/SKILL.md ↗ · machine-readable summary at /s/buddhayi-macos-cli.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

25 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +68% lift-18% tokens0% turns96% of whole cases pass with skill (24/25)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-02	✗→✓	▲ Improved	-42%	0%
case-03	✗→✓	▲ Improved	-1%	0%
case-05	✗→✓	▲ Improved	-32%	0%
case-06	✗→✓	▲ Improved	14%	0%
case-07	✗→✓	▲ Improved	-15%	0%

Showing 5 of 25 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/1/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

buddhayi / macos-cli

SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/1/2026Version v1

Skill contents

SKILL.md

macos-cli — Self-describing macOS automation router

ALWAYS START HERE: macli is self-describing. Don't guess commands — query the CLI.

macli help --json                    # → namespaces + version + discovery index
macli <ns> --json                    # → subcommand list (ns ∈ x|wx|mac)
macli help <cmd-path> --json         # → synopsis + behavior + samples (e.g. `macli help wx send --json`)
macli help errors --json             # → full error-code inventory
macli help schema --json             # → JSON envelope contract
macli mac kb-search "<intent>" --json  # → find KB script by intent (492 indexed)
macli x help --json                  # → X subsystem matrix (twitter-cli / bird / opencli / 136 sites)
macli doctor --json                  # → vendor health + cookies + cache

If macli help --json fails with command-not-found, instruct user to clone and install: git clone https://github.com/BuddhaYi/macos-cli && cd macos-cli && ./install.sh.

When to use which namespace

| User intent | Namespace | |---|---| | X/Twitter read/write/archive/download | macli x ... | | WeChat send/read/contacts | macli wx ... | | macOS dark-mode/volume/AppleScript/KB script | macli mac ... | | Any of 136 web sites (arxiv, HN, reddit, etc.) | macli <site> ... (auto-routed to X subsystem) |

Non-obvious behavioral contracts (NOT discoverable from --help)

wx send verifies by default. Polls WeChat AX tree for failure markers (重发/被对方拒收/拉黑/retry/send failed). --no-verify opts out. --retry N for transient failures.
Permanent failures (拒收/拉黑) are non-retriable. macli stops at attempt 1; do not loop the call yourself.
wx send logs every call to ~/.tx/wx_send.log (NDJSON, append-only). Non-TTY failures fire desktop notification.
X cookies live at ~/.tx/cookies.env (mode 0600). Refresh with macli x cookies-save --from edge when macli x cookies-save --check-age --json reports stale/expired.
Single X account. No multi-account support.
Rate-limit budgets (not enforced by macli — advisory to your planner): writes (post/reply/like/follow) ≤ 10/session and ≤ 30-200/day depending on action; reads unlimited; wx send ≤ 20/session.
macOS only. Refuse if user is on Linux/Windows. WeChat ops also need WeChat for Mac running + Accessibility granted to terminal.

Output

All internal commands emit {ok, schema_version: "1", data, error} when called with --json. X passthrough commands (macli x search, etc.) return the upstream tool's native JSON. Compact envelope contract: macli help schema --json.

Minimum-viable recipe (use as template, not exhaustive list)

bash
# Daily X bookmark sync, only if cookies are fresh
macli x cookies-save --check-age --json | jq -e '.data.status=="fresh"' >/dev/null \
  && macli x archive --json | jq '.data.new_count'