Overview

An embedded AI runtime for React applications. It connects your app to an AI assistant that can understand what's on screen and take action through tools.

How it works

Wrap your application in <IntentCtrlProvider>, and every component beneath it gets access to the AI chat via useIntentCtrl(). When the user sends a message, the current page is captured as structured content, bundled with your registered tools, and sent to your AI backend. The AI can respond naturally and call tools — both built-in DOM actions and your own custom functions.

What you get

• Streaming chat — real-time AI responses with a single hook
• Page-aware AI — the assistant sees the page the user is looking at
• Built-in tools — navigate, click, type, scroll, highlight, and extract page content
• Custom tools — register your own functions with typed inputs
• Permissions — control which tools the AI may use, per user
• Approval workflows — require user confirmation before sensitive actions
• Session management — persistent conversations across page visits

Requirements

Runs in the browser and requires:

• React 19 and React DOM 19
• Zod 4 — used to define tool input schemas
• An AI backend — use the cloud platform with no setup required, or self-host for free with unlimited usage. The cloud platform provides session history, analytics, and memory.

One package

npm install @intentctrl/react

That's all you need. Everything comes in a single dependency.