Skip to content

BuilderIO/agent-native

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1,896 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Agent-Native

Open-source framework for agentic applications you own.

Don't choose between rich user interfaces and autonomous agents. Every Agent-Native app is both.

Agents and UIs β€” Fully Connected

The agent and the UI are equal citizens of the same system. Every action works both ways β€” click it or ask for it.

Agents and UIs fully connected

  • Everything syncs β€” Agent and UI share one database and one state. Changes from either side show up instantly on the other.
  • Real-time multiplayer β€” Humans and agents collaborate in the same document simultaneously: CRDT merging, live presence (cursors, selection rings, who's on which slide), and the agent as a first-class peer editor. Works on any SQL database and any host, including serverless.
  • Context-aware β€” The agent knows what you're looking at. Select text, hit Cmd+I, and tell it what to do.
  • Per-user workspace β€” Skills, memory, instructions, sub-agents, and MCP servers β€” SQL-backed, customizable per user. Claude-Code-level flexibility, SaaS-grade economics.
  • Agents call agents β€” Tag another agent from any app. They discover each other over A2A and take action across your stack.
  • Reusable integrations β€” Connect a provider once in Dispatch, keep secret values in the vault, then grant apps like Brain, Analytics, Mail, and Dispatch access to the shared account metadata and credential refs.
  • Three shapes β€” Build the same agent as a headless API, a rich chat experience, or a full application where agent and UI stay in sync.
  • Apps that improve themselves β€” Your apps get better on their own. The agent can add features, fix bugs, and refine the UI over time.
  • Any database, any host β€” Any SQL database Drizzle supports. Any hosting target Nitro supports. No lock-in.
  • Bring the agent surface you need β€” MCP-compatible hosts can call your apps, coding agents can install skills, native chat renders reusable app outputs, and BYO agent runtimes can stream into the Agent-Native chat shell.

The framework for agent-native apps

Agent-Native is an open-source framework for building robust agents that can act inside real apps, not just chat next to them.

It gives you primitives for product-grade agentic software: shared actions, SQL-backed state, identity, tools, skills, jobs, observability, and UI surfaces that all work together.

Backend agnostic: bring your own database, hosting provider, model stack, and app code.

// One action powers UI, agent, HTTP, MCP, A2A, and CLI.
export default defineAction({
  schema: z.object({
    emailId: z.string(),
    body: z.string(),
  }),
  run: async ({ emailId, body }) => {
    await db.insert(replies).values({ emailId, body });
  },
});
  • Actions β€” Define work once. Use it from UI, agent, API, MCP, A2A, and CLI.
  • Agent runtime β€” Chat, tools, skills, memory, jobs, observability, and handoffs ship together.
  • Backend agnostic β€” Plug in any Drizzle-supported SQL database and Nitro-compatible host.

One agent, three product shapes

Agent-Native primitives let you choose how much UI to put around an agent without rebuilding the agent contract:

Shape What you ship Same primitives underneath
Headless Call the agent and actions from code, CLI, HTTP, MCP, or A2A. defineAction, auth, skills, memory, jobs, observability
Rich chat A standalone or embedded chat with native tables, charts, approvals, setup flows, and tool results. Shared chat runtime, BYO runtime adapters, action-declared native renderers
Whole app A full SaaS/product UI where chat can start central, move to the sidebar, and stay synced with app state. SQL state, actions, context awareness, deep links, live sync

Protocols come with the framework instead of becoming separate integrations per feature. Today that means A2A, MCP, MCP Apps, standard remote MCP OAuth, MCP clients, HTTP/CLI action calls, native chat widgets, AgentChatRuntime adapters, standard OpenAI, AG-UI, Claude Agent SDK, and Vercel AI SDK chat runtime connectors, and deep links all hang off the same action surface. ACP is best understood as the coding-agent/editor interoperability protocol, not the general BYO app-chat runtime.

For the full decision guide β€” headless, rich chat on the built-in agent, rich chat on your own agent, embedded sidecar, or full app β€” see Agent Surfaces.

To connect Claude, ChatGPT, Codex, Cursor, OpenCode, GitHub Copilot / VS Code, or another MCP host to your hosted app, see the External Agents guide.

Try it with a skill

Don't want to scaffold a whole app yet? Add visual planning and PR recaps to Claude Code, Codex, Cursor, Pi, OpenCode, GitHub Copilot / VS Code, and similar agents with one command:

npx @agent-native/core@latest skills add visual-plan

You get two slash commands that upgrade how your agent plans and reports its work:

  • /visual-plan β€” before the agent writes code, it opens a structured, reviewable plan document instead of a wall of text: inline diagrams, UI wireframes and prototypes, file-by-file implementation maps, and annotations you can comment on and approve.
  • /visual-recap β€” after changes land, it turns a PR or git diff into a high-altitude visual recap: schema, API, and file changes rendered as grounded before/after blocks with a shareable review link, instead of scrolling a raw diff.

See the Skills Guide for more skills and local installs.

Templates

Start with a full featured template. Each one is a complete, 100% free and open-source SaaS app β€” cloneable, not scaffolded β€” except you own the code and can customize everything.

Calendar

Calendar template

Agent-Native Google Calendar, Calendly

Manage events, sync with Google Calendar, and share a public booking page with AI scheduling.

Content

Content template

Open-source Obsidian for MDX

Edit local Markdown/MDX files, generate rich interactive custom blocks, and draft, rewrite, or publish with an agent.

Plans

Plans template

Visual plan mode for coding agents

Install /visual-plan and /visual-recap so your coding agent can plan before it builds and recap changes after they land β€” high-level code reviews with diagrams, wireframes, annotations, and review links.

Slides

Slides template

Agent-Native Google Slides, Pitch

Generate and edit React-based presentations via prompt or point-and-click.

Analytics

Analytics template

Agent-Native Amplitude, Mixpanel

Connect analytics data sources, prompt for real charts, and build reusable dashboards. Shared workspace connections can provide provider credentials, while Analytics still owns metrics, source-of-truth choices, and saved analyses.

Clips

Clips template

Agent-Native Loom

Record your screen with auto-transcripts, shareable links, and an agent that summarizes, captions, and edits clips on demand.

Every template is a complete cloneable SaaS β€” fork it, customize it with the agent, own it. Try them with example data before connecting your own sources.

View the full template gallery at agent-native.com/templates.

Quick Start

One command to fork a template and start building locally.

npx @agent-native/core@latest create my-platform
cd my-platform
pnpm install
pnpm dev

The CLI shows a multi-select picker so you can include as many templates as you want in one workspace. Pick Mail + Calendar + Forms and you get all three apps wired up and sharing auth in one go. Or browse the template gallery for live demos.

Want a single app, no monorepo? Use --standalone:

npx @agent-native/core@latest create my-app --standalone --template mail

Workspaces (Monorepo)

A workspace is the default shape of an agent-native project. Every app sits under apps/, and packages/shared/ is available for the small amount of code, instructions, skills, or branding that should truly apply to every app.

my-platform/
β”œβ”€β”€ package.json                   # declares `agent-native.workspaceCore`
β”œβ”€β”€ pnpm-workspace.yaml
β”œβ”€β”€ .env                           # shared secrets: ANTHROPIC_API_KEY, BUILDER_PRIVATE_KEY, A2A_SECRET, ...
β”œβ”€β”€ packages/
β”‚   └── shared/                    # optional shared custom code
└── apps/
    β”œβ”€β”€ mail/
    β”œβ”€β”€ calendar/
    └── forms/

Add another app later:

npx @agent-native/core@latest add-app notes --template content

Deploy every app behind one origin:

npx @agent-native/core@latest deploy
# https://your-agents.com/mail/*       β†’ mail
# https://your-agents.com/calendar/*   β†’ calendar
# https://your-agents.com/forms/*      β†’ forms

Same-origin deploy means a shared login session across every app and zero-config cross-app A2A β€” tag @mail from the calendar's agent chat and it just works (no JWT signing, no CORS). Full details at agent-native.com/docs/multi-app-workspace.

The Best of Both Worlds

SaaS Tools Raw AI Agents Internal Tools Agent-Native
UI Polished but rigid None Mixed quality Full UI, fork & go
AI Bolted on Powerful Shallowly connected Agent-first, integrated
Customization Can't Instructions and skills Full, but high maintenance Agent modifies the app
Ownership Rented Somewhat yours You own the code You own the code

Community

Join the Discord to ask questions, share what you're building, and get help.

Docs

Full documentation at agent-native.com.

License

MIT

About

A framework for building agent-native applications.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors