imsgctl
v1.0.0Read Apple Messages data with imsgctl: check access, list chats, inspect message history, filter by time, include attachment metadata, and watch new activity...
⭐ 0· 57·0 current·0 all-time
byJames Reagan@jpreagan
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
high confidencePurpose & Capability
Name/description match the runtime instructions: the skill is an instruction-only wrapper around the imsgctl CLI for listing chats, reading history, attachments, and watching activity. Required binary (imsgctl) and the brew formula are appropriate for this purpose.
Instruction Scope
SKILL.md instructs only local reading of message databases and using imsgctl flags/paths. It references macOS Full Disk Access and local DB paths (~/Library/Messages/chat.db and imsgkit replica.db locations) which is expected. Note: it also suggests using external tools (sips on macOS, magick on Linux) to generate image previews — these binaries are not declared as required but are optional utilities for handling attachments.
Install Mechanism
Install is via a Homebrew formula (jpreagan/tap/imsgctl). Homebrew taps are a common distribution method; this is a third-party tap (not the core/homebrew tap) which is reasonable given the project, but installing third-party taps carries more supply-chain risk than using an official repo. No archive downloads or obscure URLs are used in the install spec.
Credentials
The skill requests no credentials or environment variables. The SKILL.md references standard environment behavior (e.g., XDG_DATA_HOME) only for locating DB paths; that is proportional to the task.
Persistence & Privilege
always is false (no forced permanent inclusion). The skill is user-invocable and can be invoked autonomously by the agent (platform default). It does not request modifying other skills or system-wide settings.
Assessment
This skill is coherent for inspecting local Apple Messages data, but you should consider privacy and trust before installing: imsgctl will read highly sensitive local data (chat.db or replica.db) and on macOS may require Full Disk Access for the agent process. The brew formula comes from a third‑party tap (jpreagan/tap) — verify you trust that source before installing. Note that the instructions recommend using sips or ImageMagick to produce attachment previews; those tools may not be present and using /tmp for previews can expose temporary files. If you want to limit risk, only invoke the skill interactively (don’t grant it broad autonomous execution), verify the brew formula source, and ensure the agent process has only the minimal permissions needed (do not grant Full Disk Access unless you intentionally want the agent to read Messages data).Like a lobster shell, security has layers — review code before you run it.
latestvk97b31g9pc341wg7kc14v7gkmd83vs8r
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
Runtime requirements
OSmacOS · Linux
Binsimsgctl
Install
Homebrew
Bins: imsgctl
brew install jpreagan/tap/imsgctl