Search

Search the artifacts you can read — your own, those shared to your teams, and those in workspaces you belong to. With a query, results are ranked by relevance; without one, by most recently updated. Inside a workspace, search also ranks by meaning and prints each result’s best passages.

Usage

rip search [query] [options]

Options

Flag	Description
`--since <when>`	ISO 8601 timestamp or integer days back (e.g. `7` = last week)
`--limit <n>`	Max results (default: 50, max: 200; more is refused)
`--offset <n>`	Pagination offset
`--type <type>`	Artifact type: markdown, html, code, json, text, file, chart, table, csv
`--workspace-id <uuid>`	Search one workspace, by its UUID: ranks by keywords (and by meaning when the server has an embedding provider), prints passages and `pending`
`--artifact-id <id>`	Scope to one artifact (its ID or alias): one result whose passages are ranked best first, up to `--limit` (default 50)

Search returns live artifacts only: nothing in the trash appears.

Searching a workspace by meaning

When the server has an embedding provider, every document in a workspace is indexed by meaning when it is written. Scope a search to the workspace with --workspace-id, or to one of its documents with --artifact-id, and a plain-language question finds the passages that answer it. The output says mode: hybrid, lists each result’s best passages (section heading and full text), and shows pending: N while N chunks written a moment ago are not yet searchable by meaning. Everywhere else, and when the server has no embedding provider, search ranks by keyword (mode: keyword). See Workspace search by meaning.

Examples

rip search "quarterly report"
rip search "chart" --type chart --since 7
rip search --type table --since 7
rip search "how do we handle auth failures" --workspace-id <workspace>
rip search "termination clause" --artifact-id contract-2026 --limit 5

Output

{
  "ok": true,
  "data": {
    "results": [
      {
        "type": "artifact",
        "id": "660f9500-a1b2-4c3d-8e9f-123456789abc",
        "title": "Auth runbook",
        "updated_at": "2026-10-09T18:00:00Z",
        "snippet": "…",
        "passages": [
          {
            "section": "Token refresh",
            "text": "A failed auth refresh is retried once with backoff…",
            "chunk_index": 2
          }
        ],
        "artifact": {
          "artifact_type": "markdown",
          "version_count": 3,
          "mime_type": "text/markdown"
        }
      }
    ],
    "total": 1,
    "mode": "hybrid",
    "pending": 0
  }
}

Use --json for machine-readable JSON output.

Search results include full IDs that can be piped directly into other commands: rip artifact get <id>

Why Tokenrip

Getting Started

Core Concepts

Guides

CLI Reference

Usage

Options

Searching a workspace by meaning

Examples

Output

​Usage

​Options

​Searching a workspace by meaning

​Examples

​Output

Usage

Options

Searching a workspace by meaning

Examples

Output