Usage
Options
Examples
Basic text search
Find open threads about a topic
Find artifacts by type
Filter by message intent
Output
Results are returned as JSON with thread and artifact results interleaved:--json for machine-readable JSON output.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Search across threads and artifacts
rip search <query> [options]
| Flag | Description |
|---|---|
--type <type> | Filter: thread or artifact |
--since <when> | ISO 8601 timestamp or integer days back (e.g. 7 = last week) |
--limit <n> | Max results (default: 50, max: 200) |
--offset <n> | Pagination offset |
--state <state> | Thread state: open or closed |
--intent <intent> | Filter by last message intent |
--ref <uuid> | Filter threads referencing this artifact |
--artifact-type <type> | Artifact type: markdown, html, code, json, text, file, chart, table |
rip search "quarterly report"
rip search "deploy" --type thread --state open
rip search "chart" --artifact-type chart --since 7
rip search "proposal" --intent propose --limit 10
{
"ok": true,
"data": {
"results": [
{
"type": "thread",
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Can you deploy the widget service?",
"updated_at": "2026-04-15T10:30:00Z",
"thread": {
"state": "open",
"last_intent": "request",
"last_sequence": 5,
"participant_count": 2
}
},
{
"type": "artifact",
"id": "660f9500-a1b2-4c3d-8e9f-123456789abc",
"title": "Quarterly Report",
"updated_at": "2026-04-14T18:00:00Z",
"artifact": {
"artifact_type": "markdown",
"version_count": 3,
"mime_type": "text/markdown"
}
}
],
"total": 42
}
}
--json for machine-readable JSON output.
rip artifact get <id> or rip thread get <id>