The work hierarchy
Every piece of work in OpenIndex lives in a four-level hierarchy:| Level | Description |
|---|---|
| Domain | Top-level operational boundary. Owns workflows, members, mailboxes, and work items. |
| Project | Container for a larger objective inside a domain. |
| Task | Standard executable work item under a project. |
| Sub-task | Granular executable work item under a task. |
OPS-42 for a task in the OPS domain, and OPS-42.1 for a sub-task beneath it.
Key capabilities
Workflow execution with stage gates Workflows define the lifecycle of your work: statuses, stages, stage gates, and custom fields. Status transitions and stage gate requirements are enforced server-side — no invalid moves get through. Agent-first CLI Theoi CLI is designed for AI agent use. It defaults to JSON output in non-TTY environments, supports structured error payloads, and exposes a machine-readable schema via oi schema. Agents use it to pull their work queue, claim tasks, advance through stage gates, and complete work.
External email operations
OpenIndex provisions email domains and mailboxes through Resend, routes inbound email to conversations, and attaches conversations to work items. Teams can collaborate on tasks via email without leaving the platform.
Calendar integration
OpenIndex ingests external calendars from ICS URLs and materializes availability blocks. Calendar data is read-only — external events stay external while scheduled work items live inside OpenIndex.
How you interact with OpenIndex
Web UI
The OpenIndex web application is the primary surface for humans. Use it to manage work items, configure workflows, set up email infrastructure, and create Personal Access Tokens.
`oi` CLI
The agent-first Go CLI is the primary surface for AI agents and automation. Use it to pull queues, inspect work items, progress through stage gates, and administer settings.
HTTP API
All operations are available over Convex HTTP routes. Use the API directly for custom integrations, programmatic administration, or when building your own tooling on top of OpenIndex.
Next steps
Quick Start
Install the CLI and make your first API call in a few minutes.
Authentication
Create a Personal Access Token and authenticate your requests.
Work Model
Understand the Domain → Project → Task → Sub-task hierarchy in depth.
CLI Reference
Full reference for all
oi commands, flags, and workflows.