Repo brief: ReagentX/imessage-exporter

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T06:18:53.258Z · commit d2d7e66f184b

Verdict

Mixed — Solo project — review before adopting

• Last commit today
• GPL-3.0 licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

imessage-exporter is a Rust library and CLI tool that reads Apple's SQLite iMessage database (chat.db) and exports conversations to portable formats (HTML, TXT) while preserving media, metadata, and advanced message features like tapbacks, replies, handwriting, and digital touch. It also runs diagnostics to identify corruption or inconsistencies in the iMessage database. Workspace monorepo with two crates: imessage-database (library) and imessage-exporter (CLI binary). The library lives in imessage-database/src/ with modular error handling (src/error/), message type parsers for each feature (src/message_types/{app,digital_touch,handwriting,polls,etc}.rs), and protobuf definitions…

Start here

Open these first:

• imessage-database/src/lib.rs — Library entry point exposing all public APIs for accessing iMessage data structures and tables; required reading to…
• imessage-database/src/tables/messages/message.rs — Core message data model that powers all message extraction; contains the primary abstraction for iMessage message records.
• imessage-database/src/util/typedstream.rs — TypedStream deserialization logic for Apple's proprietary binary format used in message metadata; essential for parsing…
• imessage-database/src/message_types/mod.rs — Message type routing and variant system that dispatches different iMessage types (apps, effects, handwriting, etc.) to…
• imessage-database/build.rs — Build script that compiles protobuf definitions for Digital Touch and Handwriting message types; must run before…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/ReagentX/imessage-exporter.git
cd imessage-exporter
cargo build --release
cargo run --release -- --help

See imessage-exporter/README.md for full installation and usage details.

Daily commands:

cargo build --release
cargo run --release -- --database-path <path-to-chat.db> --output-path <export-dir> --export-format html

Exact options in imessage-exporter/README.md. Requires read access to macOS iMessage database (usually ~/Library/Messages/chat.db).

Key cautions & unknowns

• Solo or near-solo (1 contributor active in recent commits)
• GPL-3.0 is copyleft — check downstream compatibility
• Database access: The tool requires read access to ~/Library/Messages/chat.db on macOS, which may be protected by System Integrity Protection (SIP)—users may need to add the binary to Full Disk Access in Security &…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.