ctxindex
A local personal-context gateway with one deterministic CLI for agents.
ctxindex gives agents one command vocabulary for context spread across providers and local files. Mail, Calendar Events, files, and extension-defined domains become Resources with stable ctx:// Refs. Providers and the filesystem remain canonical; local projections and caches support search, retrieval, Relations, export, and narrowly typed Actions.
Mental model in five lines
- A Realm is a user-defined operating context whose Sources should be searched and reasoned about together.
- A Source is one configured connection to one provider collection or local directory, and belongs to exactly one Realm.
- A Profile defines a Resource's portable shape, searchable vocabulary, exports, Relations, Artifacts, and Actions.
- A Source Adapter performs provider or filesystem I/O and emits Resources that conform to Profiles.
- A Resource is one addressable unit of context; its stable Ref identifies it independently of local materialization.
The CLI is the agent integration surface. Agents compose commands such as search, get, thread, export, and action, request deterministic JSON where available, and use stable exit codes instead of provider-specific integrations.
Start here
Getting started
Install with Bun, configure a local Source, and run search, get, and export.
Concepts
Understand Realms, Sources, Resources, Refs, Profiles, Actions, and materialization.
CLI reference
Look up commands, arguments, output contracts, and stable exit behavior.
Guides
Follow focused workflows for agents, mail, calendars, and configured providers.
Examples
See practical command sequences built on the provider-neutral CLI.
Local Git Catalog
Discover and install trusted Profiles and Source Adapters from merged local Catalogs.