Skip to content
indx

User Stories

The reference tells you what every flag does. The guides tell you how to do one thing well. This section is different: each page is a complete story — a developer with a real problem, building a real thing with indx from an empty folder to a working result.

Every story follows the same arc:

  • The scenario — who’s building, and what’s blocking them today.
  • What you’ll build — the concrete outcome, up front.
  • The build — copy-pasteable steps, with the output you should expect.
  • What you learned — the indx ideas the story leaned on, and where to go deeper.

You don’t need to read them in order. Pick the one that looks like your problem.

The cast

Section titled “The cast”

The stories star the four indx personas — and a few of their teammates. They map back to Use Cases & Personas.

| Persona | Role | Stories | |---|---|---| | Maya | RAG / agent engineer | Grounded handbook agent, MCP for Claude & Cursor | | Devin | Enterprise / air-gapped ML lead | The air-gapped bank, the vendor-neutral migration | | Priya | OSS developer / integrator | Monorepo search, bring-your-own components | | Dr. Chen | Researcher | The citable research archive, scanned-PDF reading | | Sam, Aisha | Platform & compliance engineers | Knowledge in CI, the PII-redaction stage |

The ten stories

Section titled “The ten stories”
1 · Ground an agent in your company handbook Maya builds a support agent that answers from the handbook and cites the source — in one connect() call.
2 · Index a bank's archive, fully air-gapped Devin ingests a decade of exports with no byte leaving the network, and proves the run is auditable.
3 · Make your monorepo searchable Priya turns a repo of code, runbooks, and design docs into a relationship-aware knowledge space.
4 · A citable research archive Dr. Chen turns mixed PDFs and notes into a graph with citation and duplicate edges, then ships it as a file.
5 · Build knowledge in CI, ship it as a file Sam builds a .indx artifact on every tag, caches with --resume, and mounts it in a serverless function.
6 · Give Claude & Cursor your docs over MCP Wire a knowledge space into Claude Desktop and Cursor with one command and no client-side Python.
7 · A vendor-neutral migration layer Devin builds once and re-exports to LangChain, LlamaIndex, and pgvector without re-deriving anything.
8 · Redact PII before it reaches the cloud Aisha inserts a custom stage that strips secrets before any egress-capable component sees them.
9 · Bring your own parser, embedder, store Priya plugs a custom parser and store into the pipeline with structural typing — no subclassing.
10 · Read scanned PDFs with a vision model Marco turns a shelf of scanned reports into searchable text by enabling the VLM slot.

Where to go next

Section titled “Where to go next”