mm | VLM Run

2 min read Original article ↗

mm-ctx

Fast, multi-modal context for agents.

Familiar UNIX tools (find, grep, cat, wc) with unfamiliar multi-modal powers. A Rust-core CLI that indexes, searches, and extracts content from images, video, audio, and documents at speed.

UNIX philosophy, multi-modal powers.

Rust core for speed, Python for developer experience, and composable commands you already know. Pipe, filter, and query across every file type on disk.

60ms across 700 files

Rust-core index and fast path deliver sub-100ms metadata commands (find, wc) on realistic workloads.

UNIX-familiar commands

find, grep, cat, wc, sql. Same mental model, extended to images, video, audio, and docs.

Implicit indexing

No "build index" step. Every command auto-indexes on first use and re-uses the cache afterwards.

Content extraction

mm cat extracts text from PDFs, captions from images, and descriptions from video. Supports fast or accurate LLM mode.

SQL over your files

mm sql runs SQL against the file index, extraction results, chunks, and embeddings, all in one place.

Pipeline-friendly

JSON output (--format json) everywhere. Pipe into jq, feed into agents, or build bigger workflows.

Quick Start

Your filesystem, as structured context.

Index every image, video, PDF, and document on disk, then query them with familiar commands. Built for agents that need multi-modal context without orchestration overhead.

  • Rust-core speed with Python dev-ex
  • Works on images, video, audio, PDFs, and text
  • SQL over file metadata, content, and embeddings
  • MIT-licensed, composable with any agent framework