# Theo — ecosystem documentation

> Theo is a full-stack ecosystem for building, shipping, and scaling AI agents. This is the documentation site (docs.usetheo.dev) covering every product. This file follows the llmstxt.org convention: a curated index with links to each product and its own machine-readable ground-truth file where available. For the complete text of every page in one request, use the full corpus below.

## Full corpus

- [llms-full.txt](https://docs.usetheo.dev/llms-full.txt): every page of this site inlined as plain text (a few MB). Code samples are verbatim; site-only React components are stripped. Fetch this single file instead of crawling the site — it is regenerated from the MDX sources on every deploy, so it never lags the docs.

## Products

- [TheoKit](https://docs.usetheo.dev/theokit): Full-stack TypeScript framework for AI agents. RAG, memory, observability built in.
  - [@theokit/ui — React component library (docs.usetheo.dev/theokit/ui)](https://docs.usetheo.dev/theokit/ui): 82 AI-native React components (Violet Forge). Ground truth: https://docs.usetheo.dev/theokit/ui/llms.txt
  - [@theokit/tui — terminal component library](https://docs.usetheo.dev/theokit/tui): Ink-based agent CLI components. Ground truth: https://docs.usetheo.dev/theokit/tui/llms.txt
  - [@theokit/di — IoC container](https://docs.usetheo.dev/theokit/di): NestJS-compatible dependency-injection container (3 scopes, 4 provider types). Ground truth: https://docs.usetheo.dev/theokit/di/llms.txt
  - [@theokit/di-agent — agent-first DI](https://docs.usetheo.dev/theokit/di-agent): REQUEST-scoped @theokit/sdk Agent per request + declarative agent decorators. Ground truth: https://docs.usetheo.dev/theokit/di-agent/llms.txt
  - [@theokit/orm — DI-driven ORM](https://docs.usetheo.dev/theokit/orm): Repository pattern + @Transactional + agent-aware columns over drizzle-orm. Ground truth: https://docs.usetheo.dev/theokit/orm/llms.txt
  - [@theokit/plugins — first-party plugins](https://docs.usetheo.dev/theokit/plugins): auth providers + capability plugins (canvas, copilot, realtime, voice, forms, payments, email, db-drizzle). Ground truth: https://docs.usetheo.dev/theokit/plugins/llms.txt
- [TheoKit-SDK](https://docs.usetheo.dev/theokit-sdk): Build-your-own-agent toolkit.
- [TheoCloud](https://docs.usetheo.dev/paas): The managed runtime — from your project to a live URL in minutes.
- [Theo Knowledge](https://docs.usetheo.dev/theo-knowledge): RAG with citations — drop documents in, get cited answers out.
- [Theo Prompts](https://docs.usetheo.dev/theo-prompts): Versioned prompts, resolved at runtime — promote without a redeploy.
- [Theo Memory](https://docs.usetheo.dev/theo-memory): Persistent memory for agents — remember, recall, forget, reflect.
- [Theo Guardrails](https://docs.usetheo.dev/theo-guardrails): Composable inline guardrails — mask credentials, redact PII, block.
- [Theo Traces](https://docs.usetheo.dev/theo-traces): OpenTelemetry-native trace explorer for AI agents.
- [TheoDB](https://docs.usetheo.dev/theodb): AI + vector search as SQL, inside Postgres.

## Per-package ground truth (llms.txt)

- [@theokit/ui](https://docs.usetheo.dev/theokit/ui/llms.txt): full 82-component inventory, import paths, conventions
- [@theokit/tui](https://docs.usetheo.dev/theokit/tui/llms.txt): full terminal-component inventory
- [@theokit/di](https://docs.usetheo.dev/theokit/di/llms.txt): container API, provider types, scopes, honest v1 status of metadata-only decorators
- [@theokit/di-agent](https://docs.usetheo.dev/theokit/di-agent/llms.txt): createAgentProvider / @InjectAgent + full declarative decorator catalogue
- [@theokit/orm](https://docs.usetheo.dev/theokit/orm/llms.txt): Repository API, OrmModule, @Transactional, agent-aware columns, schema export
- [@theokit/plugins](https://docs.usetheo.dev/theokit/plugins/llms.txt): 11 first-party plugins (auth + capability), factories, peers, honest v0.x status

## Notes for agents

- @theokit/ui is the AI-native React library (coding-agent + chat surfaces). Generic primitives, auth surfaces, and cloud-ops composites live in the sibling package @usetheo/ui — do not expect them under @theokit/ui.
- The former /theoui section was retired 2026-07-10; /theoui/* now redirects to /theokit/ui.
- @theokit/di, @theokit/di-agent, and @theokit/orm are backend/DI libraries (one monorepo: github.com/usetheodev/theokit-di), separate from the ui/tui component libraries. Their llms.txt files are explicit about v1 status: several @theokit/di decorators (@Primary/@Qualifier/@PostConstruct/@PreDestroy) and most @theokit/di-agent decorators are metadata-only — do not assume they self-wire.
- @theokit/plugins are separate installable @theokit/* packages (their own monorepo: github.com/usetheodev/theokit-plugins), independently versioned and mostly v0.x. Two families: auth providers are factories for @theokit/sdk defineAuth (NOT standalone servers), and capability plugins register in theo.config.ts / expose defineRoute-wired endpoints. See their llms.txt for per-plugin factory names, peers, and honest gotchas.