imsg-grep 0.1.2-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7cef5eafcce4406fd5d337becf68f32ac9a2f40a20895231792054220106e763
+  data.tar.gz: 6a6a717d0c20fa8f5cf17ac7c61e9967bee3ee3880b1ac5846df621807599e94
+SHA512:
+  metadata.gz: 7dc965a315ffae770ed3a8e15d4c58db6fa6480ba33c3219a377beef5c216f7cb963c9dc2e9ee8cf4dda0c76e551a57f0032bd9e25ca6ee656dd192d0bdc3a3e
+  data.tar.gz: 4ffcf9b52f30390cf20f5da84ee5bddbaa2f4002eafa6c869cc7704dbddf783dc9362918e13c5120ae2a8b42a30461d22e02ee3fc88cfa25dec625780611856c

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Caio Chassot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,95 @@
+# imsg-grep
+
+Search and filter iMessage history from command line.
+
+## Features
+
+Search iMessage history with regex patterns, date ranges, and participant filters. Extract links and media files. Output text or JSON.
+
+- Contact filtering (sender/recipient matching)
+- Date range queries with relative formats
+- Link extraction (YouTube, Twitter, etc.)
+- File and image attachment search
+- Inline terminal images
+- Boolean expressions
+
+## Requirements
+
+macOS, ruby 3.4+, SQLite.
+
+iTerm or Ghostty (or other kitty) for image support. 
+
+## Installing
+
+```
+gem install imsg-grep
+```
+
+## Usage
+
+```
+imsg-grep [options] [PATTERN]
+```
+
+## Key Options
+
+**Date filtering:**
+- `-d, --since DATE` - Match after date
+- `-u, --until DATE` - Match before date
+
+**Participants:**
+- `-f, --from CONTACT` - Match sender
+- `-t, --to CONTACT` - Match recipients
+- `-w, --with CONTACT` - Match sender or recipients
+- `-c, --chat [PATTERN]` - Match group chats
+
+**Messages:**
+- `-M, --message PATTERN` - Match message text
+- `-s, --sent` - Only sent messages
+- `-r, --received` - Only received messages
+- `-n, --max NUM` - Limit results
+
+**Links:**
+- `-L, --links [PATTERN]` - Find links
+- `-Y, --youtube` - Find YouTube links
+- `-X, --twitter` - Find Twitter links
+
+**Format:**
+- `-l, --one-line` - Compact format
+- `-j, --json` - JSON output
+- `-o, --capture [EXPR]` - Extract matched parts
+- `-k, --count` - Show total count
+
+**Media:**
+- `-F, --files [KIND]` - Find file attachments
+- `-g, --images` - Find images with preview
+
+See [`--help`](doc/HELP) for more.
+
+## Examples
+
+```bash
+# Basic search
+imsg-grep "hello"
+
+# From specific contact since date
+imsg-grep -f Alice -d 2024-01-01 "meeting"
+
+# YouTube links in group chats
+imsg-grep -c -Y
+
+# Extract usernames from mentions
+imsg-grep -o '@(\w+)' '@\w+'
+
+# JSON output
+imsg-grep -j -f Bob -d 1w
+```
+
+## Date Formats
+
+- ISO8601: `2024-12-30`, `2024-12-30T12:45Z`
+- Relative: `1w` (1 week), `30min`, `3a` (3am today)
+
+## Patterns
+
+Regular expressions by default. Use `-q` for literal matching, `-i/-I` for case control.