Skip to content

Arivie documentation

Production-grade agentic analytics for your application

Arivie is a TypeScript framework built on Mastra that adds an agentic analytics surface to your app. One Arivie instance serves one owner; multi-tenant SaaS deploys N instances via @arivie/deploy recipes (Sprint 5).

Semantic layer

YAML entities under semantic/ — validated, linted, and loaded into the agent via preload, browse, or RAG modes (REQ-13–17).

Agent loop

Mastra Agent with explore + execute tools, self-correction, and structured assumptions (REQ-9–12).

Boundary

Single owner.id per instance with startup owner-identity assertion against Postgres (REQ-5–8).

Surfaces

HTTP handlers, MCP parity, React hooks, and a shadcn-style registry for <AgentChat> and dev panels (REQ-26–29).

  1. Quickstart — init → setup → model key → entity → UI → streamed answer.
  2. Concepts — architecture grounded in RFC-002 and the project pivot doc.
  3. Integrations — Clerk, WorkOS, Better Auth, Auth.js, or custom JWT (jose).

Canonical runnable code lives in arivie/examples/with-*; this site embeds those files at build time so docs stay in sync.