Skip to content
Arivie

Arivie documentation

Production-grade agentic analytics for your application
Quickstart (< 10 min) Why Arivie

What you get

Section titled “What you get”

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.

Semantic layer

YAML entities under semantic/ — validated, linted, and loaded into the agent via preload or indexed (vector) context modes.

Agent loop

Mastra Agent with execute_<source> tools, workspace tools, self-correction, and structured assumptions. Single-agent architecture — no supervisor.

Boundary

Single owner.id per instance with startup owner-identity assertion against Postgres.

Triggers & channels

Webhook-driven event pipelines via defineTrigger, defineChannel, and defineSubscription — route GitHub pushes, alerts, or any HTTP event to the agent.

Tool approval

Configurable HITL gate via requireToolApproval — global, allow-list, deny-list, or per-user function.

Schedules

Recurring analysis workflows with defineSchedule and Mastra cron triggers.

Start here

Section titled “Start here”
  1. Quickstart — init to streamed answer in under 10 minutes.
  2. Concepts — architecture, agent loop, boundary, triggers, and more.
  3. Integrations — Better Auth or custom JWT (jose).

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