# agent-native | Builder.io | Knowledge Base | Instagit

A framework for building agent-native applications.

GitHub Stars: 1.2k

Repository: https://github.com/BuilderIO/agent-native

---

## Articles

### [Recommended Tooling for Working with Builder.io Agent Native: Complete Developer Setup Guide](/BuilderIO/agent-native/recommended-tooling-builderio-agent-native)

Discover recommended tooling for Builder.io Agent Native. Set up your development environment with pnpm, Node.js, CLI, oxfmt, and Vitest for seamless integration.

- Tags: getting-started
- Published: 2026-07-18

### [Builder.io Agent Native Best Practices: A Complete Implementation Guide](/BuilderIO/agent-native/best-practices-builderio-agent-native)

Implement Builder.io Agent Native best practices. Use action surface as source of truth, persist state in SQL, route calls via provider-api-catalog, and ensure UI/agent use identical typed actions.

- Tags: best-practices
- Published: 2026-07-18

### [Builder.io Agent Native Dependencies: Complete Monorepo Package Guide](/BuilderIO/agent-native/dependencies-builderio-agent-native)

Discover the complete monorepo package guide for Builder.io Agent Native dependencies. Explore core runtime, AI SDKs, UI primitives, and platform-specific extensions.

- Tags: package-guide
- Published: 2026-07-18

### [Builder.io Agent Native Examples and Demo Code: A Complete Guide](/BuilderIO/agent-native/examples-demo-code-builderio-agent-native)

Explore Builder.io Agent Native examples and demo code within the BuilderIO/agent-native repository. Find fully functional apps in templates/ demonstrating real-world use cases.

- Tags: examples
- Published: 2026-07-18

### [What Is the Role of the lib and utils Directory in Builder.io Agent Native?](/BuilderIO/agent-native/role-lib-utils-directory-builderio-agent-native)

Discover the role of lib and utils directories in Builder.io Agent Native. Learn how these directories provide SSR-safe utilities and reusable code for focused business logic.

- Tags: internals
- Published: 2026-07-18

### [State Management in Builder.io Agent Native: SQL-Backed Architecture Explained](/BuilderIO/agent-native/state-management-builderio-agent-native)

Discover how Builder.io Agent Native manages state with a SQL-backed architecture and a type-safe API for seamless UI synchronization. Learn to read and write app state efficiently.

- Tags: architecture
- Published: 2026-07-18

### [Development Environment Configuration Files in Builder.io Agent Native](/BuilderIO/agent-native/dev-environment-config-builderio-agent-native)

Explore Builder.io Agent Native development environment configuration files for TypeScript, Vite, testing, and env vars. Organize your projects effectively.

- Tags: how-to-guide
- Published: 2026-07-18

### [What Build Tools and Bundlers Power Builder.io Agent Native?](/BuilderIO/agent-native/build-tools-bundlers-builderio-agent-native)

Discover the build tools powering Builder.io Agent Native. Learn how Vite and Rollup are used for efficient development and optimized production builds.

- Tags: deep-dive
- Published: 2026-07-18

### [How Tests Are Organized in Builder.io Agent Native: Co-Location and Feature-Centric Structure](/BuilderIO/agent-native/test-organization-builderio-agent-native)

Discover how Builder.io Agent Native organizes tests. Learn about co-location within templates and the feature-centric structure placing test files alongside source code for efficient development.

- Tags: how-to-guide
- Published: 2026-07-18

### [What Is the Purpose of the src Directory in Builder.io Agent Native?](/BuilderIO/agent-native/purpose-src-directory-builderio-agent-native)

Discover the purpose of the src directory in Builder.io Agent Native. Learn how it organizes TypeScript source files for efficient development and production builds.

- Tags: internals
- Published: 2026-07-18

### [What Frontend Frameworks Power Builder.io Agent Native?](/BuilderIO/agent-native/frontend-frameworks-builderio-agent-native)

Discover the frontend frameworks powering Builder.io Agent Native. Learn how React, Next.js, and shadcn/ui create its dynamic interface.

- Tags: deep-dive
- Published: 2026-07-18

### [Main Directories in the Builder.io Agent Native Repository: Complete Structure Guide](/BuilderIO/agent-native/main-directories-builderio-agent-native)

Explore the Builder.io Agent Native repository structure. Understand key directories like packages and templates to effectively use the codebase.

- Tags: structure-guide
- Published: 2026-07-18

### [Builder.io Agent Native Project Structure: A Complete Guide to the Monorepo Architecture](/BuilderIO/agent-native/project-structure-builderio-agent-native)

Learn the Builder.io Agent Native project structure a monorepo with a four-area architecture UI actions skills and state. Explore top-level directories like app actions and packages.

- Tags: architecture
- Published: 2026-07-18

### [How to Implement Output Schema Validation for Agent Action Return Values in Agent-Native](/BuilderIO/agent-native/how-to-implement-output-schema-validation-for-action-return-values)

Learn to implement output schema validation for Agent-Native action return values. Ensure data integrity and catch errors automatically with Agent-Native's built-in validation.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Generative UI with Transient Chat Components in Agent-Native](/BuilderIO/agent-native/how-to-implement-generative-ui-with-transient-chat-components)

Learn how to implement generative UI with transient chat components in Agent-Native using render inline extension. Create dynamic, temporary UI elements for interactive chat experiences.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Set Up Observability and Tracing for Agent-Native Applications: A Complete Guide](/BuilderIO/agent-native/how-to-set-up-observability-and-tracing-in-agent-native)

Learn how to set up observability and tracing for Agent-Native applications. Discover automatic run capture, quality evaluation, and metrics surfacing without custom code. Complete guide for BuilderIO Agent-Native.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Sharing and Access Control in Agent-Native Using the `accessFilter`](/BuilderIO/agent-native/how-to-implement-sharing-and-access-control-with-accessfilter)

Learn to implement sharing and access control in Agent-Native with accessFilter. This guide shows how to generate SQL WHERE clauses for ownership and permissions.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Automations in Agent-Native Based on Event Triggers](/BuilderIO/agent-native/how-to-implement-automations-with-event-triggers-in-agent-native)

Learn to implement automations in Agent-Native using event triggers. Explore the trigger, processing, and action layers to build LLM-powered workflows for Gmail and execute side-effects.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Set Up Recurring Jobs with Cron Schedules in Agent-Native](/BuilderIO/agent-native/how-to-set-up-recurring-jobs-with-cron-schedules-in-agent-native)

Easily set up recurring jobs with cron schedules in Agent-Native. Our pure-function wrapper validates and humanizes cron expressions for reliable task automation.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Frontend Data Fetching with useActionQuery and useActionMutation Hooks in Agent-Native](/BuilderIO/agent-native/how-to-implement-frontend-data-fetching-with-useactionquery-and-useactionmutation)

Learn frontend data fetching in Agent-Native using useActionQuery and useActionMutation hooks. Simplify REST calls with typed actions, caching, and retries via React Query.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Prevent SSRF Vulnerabilities in Agent-Native Using ssrfSafeFetch](/BuilderIO/agent-native/how-to-use-ssrfsafefetch-to-prevent-ssrf-vulnerabilities)

Prevent SSRF vulnerabilities in Agent-Native with ssrfSafeFetch. Learn how four validation layers secure server-side requests and protect your application.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Organization Management in Agent-Native Using the orgmembers Tables](/BuilderIO/agent-native/how-to-implement-organization-management-with-org-members-tables)

Implement organization management in Agent-Native using orgmembers tables. Create organizations, manage members via email, and secure resources with database-level access control.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Set Up Encrypted Credentials in Agent-Native Using `saveCredential` and `resolveCredential`](/BuilderIO/agent-native/how-to-set-up-encrypted-credentials-with-savecredential-and-resolvecredential)

Secure your AI agent with Agent-Native's encrypted credentials. Learn to use saveCredential and resolveCredential for seamless AES-256-GCM encryption and decryption.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Perform Surgical Edits on Large Text or JSON Columns Using db‑patch in Agent‑Native](/BuilderIO/agent-native/how-to-use-db-patch-for-surgical-edits-on-large-data)

Efficiently edit large text or JSON columns in Agent-Native with db-patch. Learn to use this CLI action for compact diffs and save tokens on massive blobs.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Create Sandboxed Extensions Using Alpine.js in Agent-Native](/BuilderIO/agent-native/how-to-create-sandboxed-extensions-with-alpine-js-in-agent-native)

Learn to build secure sandboxed extensions with Alpine.js in Agent-Native. Explore five helper functions for safe host system interaction.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Set Up Real-Time UI Synchronization in Agent-Native Using the useDbSync Hook](/BuilderIO/agent-native/how-to-set-up-real-time-ui-synchronization-with-usedbsync)

Learn to set up real-time UI synchronization in Agent-Native with the useDbSync hook. Automatically sync your React UI with database changes via SSE or polling.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Use the `needsApproval` Feature for Human-in-the-Loop Agent Actions in Agent-Native](/BuilderIO/agent-native/how-to-use-needsapproval-for-human-in-the-loop-agent-actions)

Master Agent-Native's needsApproval feature for human-in-the-loop agent actions. Block the agent loop and require explicit user confirmation for critical operations.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Secure Custom API Routes in Agent-Native Using getSession and Access Control](/BuilderIO/agent-native/how-to-secure-custom-api-routes-with-getsession-and-access-control)

Secure Agent-Native custom API routes! Learn to use getSession and access control for robust authentication and authorization. Protect your sensitive data and logic effectively.

- Tags: how-to-guide
- Published: 2026-07-02

### [Agent-Native Authentication Modes: Dev, Production, and Local Configuration Guide](/BuilderIO/agent-native/agent-native-authentication-modes-configuration)

Explore Agent-Native authentication modes: dev auto-login, production Better Auth, and local CLI. Configure dev, production, and local environments using environment variables for secure access.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Define Custom Actions with defineAction and Validate Them with Zod in Agent-Native](/BuilderIO/agent-native/how-to-define-custom-actions-with-defineaction-and-zod-schema-validation)

Learn to define custom actions with defineAction in Agent-Native. Validate inputs and outputs seamlessly using Zod schemas for robust server-side functions.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement Data Scoping Using owner_email and org_id in Agent-Native](/BuilderIO/agent-native/how-to-implement-data-scoping-with-owner-email-and-org-id-in-agent-native)

Learn how to implement data scoping in Agent Native using owner_email and org_id for robust row-level security. Protect personal and organizational boundaries effectively.

- Tags: how-to-guide
- Published: 2026-07-02

### [Best Practices for Modifying BuilderIO/agent-native Root Files: A Complete Guide](/BuilderIO/agent-native/best-practices-for-modifying-builderio-agent-native-root-files)

Safely modify BuilderIO/agent-native root files with these best practices. Learn about prep commands, invariant scripting, and Changesets for monorepo management.

- Tags: best-practices
- Published: 2026-07-01

### [BuilderIO/agent-native Root Directory: Complete Monorepo Structure Guide](/BuilderIO/agent-native/builderio-agent-native-what-to-expect-in-the-root-directory)

Explore the BuilderIO/agent-native root directory for a complete TypeScript monorepo structure guide. Discover manifest files, workspace config, and documentation for framework packages and applications.

- Tags: guide
- Published: 2026-07-01

### [How BuilderIO/agent-native Handles Dependencies Defined in Root Files](/BuilderIO/agent-native/how-does-builderio-agent-native-handle-dependencies-defined-in-root-files)

Discover how BuilderIO/agent-native manages root dependencies using a pnpm monorepo architecture controlled by pnpm-workspace.yaml and custom guard scripts for efficient dependency management.

- Tags: internals
- Published: 2026-07-01

### [Building BuilderIO/agent-native from Source: Root File and Monorepo Configuration](/BuilderIO/agent-native/building-builderio-agent-native-from-source-root-file-considerations)

Build BuilderIO/agent-native from source by configuring package.json, pnpm-workspace.yaml, and prebuild scripts to compile the core framework. Master your monorepo setup.

- Tags: internals
- Published: 2026-07-01

### [Understanding the BuilderIO/agent-native Codebase: Root Files Explained](/BuilderIO/agent-native/understanding-the-builderio-agent-native-codebase-root-files)

Explore the BuilderIO/agent-native codebase root files. Discover a TypeScript monorepo where AI agents and UI components share SQL-backed logic, enforced by guard scripts and contracts.

- Tags: internals
- Published: 2026-07-01

### [Navigating the BuilderIO/agent-native Repository: Root Files Explained](/BuilderIO/agent-native/navigating-builderio-agent-native-repository-root-files-explained)

Understand the BuilderIO/agent-native root files. Discover how these files enable an action-centric architecture, sharing business logic across UI, agent, and API.

- Tags: internals
- Published: 2026-07-01

### [Root-Level Files in BuilderIO/agent-native: Complete Repository Structure Guide](/BuilderIO/agent-native/what-are-the-root-level-files-in-builderio-agent-native)

Explore root-level files in BuilderIO/agent-native, including package.json, agent-native.json, and wrangler config. Understand the repository structure for efficient development.

- Tags: how-to-guide
- Published: 2026-07-01

### [BuilderIO/agent-native README.md: Framework Documentation and Architecture Guide](/BuilderIO/agent-native/readme-functionality-builderio-agent-native)

Explore BuilderIO/agent-native's functionality with its comprehensive README.md. Learn about Actions, Agent runtime, and get quick-start guides for building agent-native apps.

- Tags: architecture
- Published: 2026-06-30

### [How to Set Up Recurring Jobs and Scheduled Tasks in Agent-Native](/BuilderIO/agent-native/how-to-set-up-recurring-jobs-and-scheduled-tasks)

Learn to set up recurring jobs and scheduled tasks in Agent-Native using Nitro plugins and `registerJob`. Schedule tasks with cron expressions or fixed intervals for efficient background work.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Handle Abort Signals in Long-Running Agent Actions in BuilderIO Agent-Native](/BuilderIO/agent-native/how-to-handle-abort-signals-in-long-running-agent-actions)

Learn to handle abort signals in long-running agent actions by passing an AbortSignal through the agent context for immediate cancellation of async operations like fetch and LLM calls.

- Tags: how-to-guide
- Published: 2026-06-29

### [How Audit Logging Tracks Changes in Agent-Native: A Complete Implementation Guide](/BuilderIO/agent-native/how-audit-logging-tracks-who-changed-what-and-when)

Discover how Agent-Native audit logging tracks every change using an append-only SQL table. Learn about strict tenant isolation and secure access for authorized users. Implement comprehensive change tracking.

- Tags: how-to-guide
- Published: 2026-06-29

### [How the Brand Kit Extracts Design Systems from Figma in Agent-Native](/BuilderIO/agent-native/how-brand-kit-extracts-design-systems-from-figma)

Learn how the brand kit extracts design systems from Figma by uploading `.fig` files for asynchronous indexing. Monitor the process with job identifiers for efficient design system management.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Implement Access Control with Ownable Columns and Scoped Queries in Agent-Native](/BuilderIO/agent-native/how-to-implement-access-control-with-ownable-columns-scoped-queries)

Implement secure access control in Agent-Native. Learn to use ownable columns and scoped queries to manage user permissions effectively and protect your data.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Add Custom Provider API Integrations Beyond the Built-In Catalog in Agent-Native](/BuilderIO/agent-native/how-to-add-custom-provider-api-integrations-beyond-built-in-catalog)

Easily extend Agent-Native by registering custom API providers at runtime. Integrate any external service beyond the built-in catalog with simple configuration.

- Tags: how-to-guide
- Published: 2026-06-29

### [How the Event Bus Handles Real-Time Communication Between Agent-Native Components](/BuilderIO/agent-native/how-event-bus-handles-real-time-communication-between-components)

Discover how the agent-native event bus ensures real-time communication. Learn about its typed pub/sub, Zod-validated payloads, and isolated dispatch for instant propagation.

- Tags: internals
- Published: 2026-06-29

### [How Real-Time Sync Keeps the UI in Sync with Agent Changes in Agent-Native](/BuilderIO/agent-native/how-real-time-sync-keeps-ui-in-sync-with-agent-changes)

Learn how Agent-Native's real-time sync uses SSE and polling to instantly update the UI with agent changes, ensuring seamless consistency with versioned events and targeted cache invalidation.

- Tags: internals
- Published: 2026-06-29

### [How Drizzle Schema Migrations Work Across Database Providers in Agent Native](/BuilderIO/agent-native/how-drizzle-schema-migrations-work-across-different-database-providers)

Learn how Agent Native's Drizzle schema migrations work seamlessly across PostgreSQL, Turso, pglite, and SQLite with automatic dialect detection, no provider-specific code needed.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Securely Manage Secrets and Environment Variables in Agent-Native Projects](/BuilderIO/agent-native/how-to-manage-secrets-and-environment-variables-securely)

Securely manage secrets and environment variables in agent-native projects. Learn how agent-native uses encrypted vaults and guard scripts for robust security.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Embed an Agent-Native Application Within an Existing App](/BuilderIO/agent-native/how-to-embed-agent-native-app-inside-another-application)

Embed an Agent-Native application in your app using the <EmbeddedApp> component. Securely communicate via a sandboxed iframe and message bridge for seamless integration.

- Tags: how-to-guide
- Published: 2026-06-29

### [How to Use the Provider API Catalog System for Research in Agent Native](/BuilderIO/agent-native/how-to-use-provider-api-catalog-system-research)

Learn how to use the provider API catalog system to research external services in Agent Native. Discover, document, and execute HTTP requests seamlessly with our three-step workflow.

- Tags: how-to-guide
- Published: 2026-06-28

### [How to Implement Recurring Jobs with cron-parser in Agent-Native](/BuilderIO/agent-native/implement-recurring-jobs-cron-parser-agent-native)

Learn how to implement recurring jobs with cron-parser in Agent-Native. Discover functions to validate, describe, and schedule cron-based jobs within the framework.

- Tags: how-to-guide
- Published: 2026-06-28

### [Agent-Native CLI Template Creation Modes: Interactive, Non-Interactive, and Template-Specific](/BuilderIO/agent-native/agent-native-cli-template-creation-modes)

Discover Agent-Native CLI template creation modes: interactive, non-interactive with --yes, and template-specific generation with --template. Scaffold projects efficiently.

- Tags: how-to-guide
- Published: 2026-06-28

### [How the Agent-Native Polling Mechanism Syncs UI with SSE and HTTP Fallback](/BuilderIO/agent-native/how-polling-mechanism-sync-ui-agent-native)

Learn how Agent-Native synchronizes UI with SSE and HTTP fallback. Discover the polling mechanism managed by the useDbSync hook for real-time updates.

- Tags: internals
- Published: 2026-06-28

### [Security Best Practices for Schema Changes in Agent-Native: A Complete Guide](/BuilderIO/agent-native/security-best-practices-schema-changes-agent-native)

Learn Agent-Native security best practices for schema changes. Explore additive-only migrations, access control, and safe defaults to protect your production data.

- Tags: best-practices
- Published: 2026-06-28

### [How to Configure Agent-Native Deployment with Postgres, Turso, SQLite, and PGlite](/BuilderIO/agent-native/configure-agent-native-deployment-database-providers)

Learn how to configure Agent-Native deployment with Postgres, Turso, SQLite, and PGlite. Easily integrate your preferred SQL provider using Drizzle ORM and environment variables.

- Tags: how-to-guide
- Published: 2026-06-28

### [Performance Optimization Strategies in Agent-Native: 7 Techniques for Sub-Second Apps](/BuilderIO/agent-native/agent-native-performance-optimization-strategies)

Learn 7 performance optimization strategies in Agent-Native for sub-second apps. Discover techniques for fast list loads and real-time sync without database tuning.

- Tags: performance
- Published: 2026-06-28

### [How to Create Custom Skills for Agent Instructions in Agent-Native](/BuilderIO/agent-native/how-to-create-custom-skills-agent-instructions-agent-native)

Learn to create custom skills for Agent Instructions in Agent-Native. Follow our simple guide to add powerful new abilities to your agents using markdown.

- Tags: how-to-guide
- Published: 2026-06-28

### [What Is the Agent-Native Skills System?](/BuilderIO/agent-native/what-is-agent-native-skills-system)

Learn about the Agent-Native skills system, a flexible framework that empowers coding agents with reusable capabilities using markdown and slash commands. Enhance your agent's functionality with this extensible system.

- Tags: deep-dive
- Published: 2026-06-28

### [How to Audit Log Changes with list-audit-events in Agent-Native](/BuilderIO/agent-native/how-to-audit-log-changes-list-audit-events-agent-native)

Learn how to audit log changes with list-audit-events in Agent-Native. Query immutable audit records efficiently and effectively with this powerful tool.

- Tags: how-to-guide
- Published: 2026-06-28

### [How the Sharing System in Agent-Native Works: Ownership, Visibility, and Access Control](/BuilderIO/agent-native/how-agent-native-sharing-system-work)

Discover the Agent-Native sharing system: understand ownership rights, data visibility, and access control for all user resources through its unified privacy model.

- Tags: internals
- Published: 2026-06-28

### [How to Create Sandboxed Alpine.js Extensions in Agent-Native: A Complete Guide](/BuilderIO/agent-native/how-to-create-sandboxed-alpine-js-extensions-agent-native)

Learn to create sandboxed Alpine.js extensions in Agent-Native. Build self-contained mini-apps that securely communicate with your host application using injected helpers. Get the complete guide today.

- Tags: how-to-guide
- Published: 2026-06-28

### [How Agent-Native Integrates with MCP (Model Context Protocol): Complete Implementation Guide](/BuilderIO/agent-native/how-agent-native-integrates-mcp-model-context-protocol)

Learn how Agent-Native integrates with MCP via its built-in connector. Discover auto-exposed actions, HTTP endpoints, and embedded React components for seamless implementation.

- Tags: how-to-guide
- Published: 2026-06-28

### [Understanding the A2A Protocol for Agent-to-Agent Communication in BuilderIO Agent-Native](/BuilderIO/agent-native/what-is-a2a-protocol-agent-to-agent-communication)

Discover the A2A protocol for agent-to-agent communication in BuilderIO Agent-Native. Learn about its JSON-RPC, JWT, and task-store architecture for secure and efficient remote calls.

- Tags: deep-dive
- Published: 2026-06-28

### [How to Use the Authentication Skill in Agent-Native: Configuration and Implementation Guide](/BuilderIO/agent-native/how-to-use-authentication-skill-agent-native)

Learn to use the Agent-Native authentication skill for secure session management. This guide covers configuration and implementation for browser and programmatic clients.

- Tags: how-to-guide
- Published: 2026-06-28

### [How Context-Awareness Works in Agent-Native to Expose UI State](/BuilderIO/agent-native/how-does-context-awareness-work-agent-native)

Discover how Agent-Native achieves context-awareness by synchronizing UI state to a shared store, enabling agents to read and command navigation seamlessly.

- Tags: internals
- Published: 2026-06-28

### [What Is the `application_state` Table in Agent-Native?](/BuilderIO/agent-native/what-is-application-state-table-agent-native)

Explore the application_state table in Agent-Native. Discover how this SQL-backed store manages transient UI and navigation data for seamless agent and frontend component interaction.

- Tags: deep-dive
- Published: 2026-06-28

### [How to Use the Agent-Native Collab Module for Real-Time Features](/BuilderIO/agent-native/how-to-use-agent-native-collab-module)

Learn to implement real-time features with the Agent-Native collab module. Leverage Yjs for multi-user editing, conflict resolution, and server persistence without custom WebSocket code.

- Tags: how-to-guide
- Published: 2026-06-28

### [How Agent-Native Handles Real-Time Collaboration with Yjs CRDT](/BuilderIO/agent-native/agent-native-real-time-collaboration-yjs-crdt)

Discover how Agent-Native achieves seamless real-time collaboration using Yjs CRDT. Explore its robust server client architecture for instant updates and presence.

- Tags: deep-dive
- Published: 2026-06-28

### [How Agent-Native Communicates with the UI Using Shared SQL State](/BuilderIO/agent-native/agent-native-ui-communication-shared-sql-state)

Discover how Agent-Native synchronizes LLM agents and UIs. Learn about its shared SQL state `application_state` and lightweight polling for real-time communication.

- Tags: internals
- Published: 2026-06-28

### [Agent-Native Runtime Architecture: How BuilderIO/agent-native Unifies UI, AI, and State](/BuilderIO/agent-native/what-is-agent-native-runtime-architecture)

Explore the Agent-Native runtime architecture by BuilderIO/agent-native. Learn how it unifies React UI, AI, and state with a SQL layer and Run Manager for durable background execution and real-time events.

- Tags: architecture
- Published: 2026-06-28

### [How to Define a New Action in Agent-Native Using `defineAction`](/BuilderIO/agent-native/how-to-define-new-action-agent-native-defineaction)

Learn to define a new action in Agent Native using defineAction. Import it, create a Zod schema for validation, implement your business logic with an async run function, and export the default.

- Tags: how-to-guide
- Published: 2026-06-28

### [How to Set Up Multi-Provider Analytics Tracking (PostHog, Mixpanel, Amplitude) in Agent-Native](/BuilderIO/agent-native/setting-up-multi-provider-analytics-agent-native)

Easily set up multi-provider analytics tracking for PostHog, Mixpanel, and Amplitude in agent-native. Securely forward events with server-side batching for optimal performance.

- Tags: how-to-guide
- Published: 2026-06-27

### [Implementing Self-Modifying Code in Agent-Native: A Complete Guide to AI-Driven Source Editing](/BuilderIO/agent-native/implementing-self-modifying-code-agent-native-source-editing)

Learn to implement self modifying code in Agent Native. Our guide details AI driven source editing with safe, guarded transactions for reliable code modifications.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Use `/visual-plan` and `/visual-recap` Slash Commands with Coding Agents in Agent-Native](/BuilderIO/agent-native/using-visual-plan-visual-recap-slash-commands-coding-agents-agent-native)

Master Agent-Native's visual-plan and visual-recap slash commands. Generate structured MDX plans and recaps for safer, traceable, and collaborative coding workflows with MCP tools.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Optimize List Queries with Column Projection and Indexing in Agent-Native](/BuilderIO/agent-native/optimizing-list-queries-column-projection-indexing-agent-native)

Optimize Agent-Native list queries using column projection and indexing. Boost performance by avoiding full-table scans and reducing memory usage.

- Tags: performance
- Published: 2026-06-27

### [Implementing Sharing and Access Control with ownableColumns in agent-native](/BuilderIO/agent-native/implementing-sharing-access-control-ownablecolumns-agent-native)

Learn to implement sharing and access control in agent-native using ownableColumns. Effortlessly manage data access with accessFilter and assertAccess for secure applications.

- Tags: how-to-guide
- Published: 2026-06-27

### [How Agent-Native Handles Automations with Schedule‑Triggered Conditions](/BuilderIO/agent-native/handling-automations-schedule-triggered-conditions-agent-native)

Learn how Agent-Native handles schedule-triggered automations. Discover its database scheduler and automation engine integration for efficient rule execution.

- Tags: how-to-guide
- Published: 2026-06-27

### [Handling Event-Triggered Automations in Agent-Native: A Technical Deep Dive](/BuilderIO/agent-native/handling-automations-event-triggered-conditions-agent-native)

Master event-triggered automations in Agent-Native. Learn how this technical deep dive explains incremental fetching, AI rule evaluation, and state synchronization for efficient Gmail automation.

- Tags: deep-dive
- Published: 2026-06-27

### [Adding Custom Server Plugins to Agent-Native's /_agent-native/ Route](/BuilderIO/agent-native/adding-custom-server-plugins-agent-native-route)

Extend Agent-Native's /_agent-native/ route by creating custom server plugins. This guide shows how to add new HTTP handlers using defineNitroPlugin in your TypeScript files.

- Tags: how-to-guide
- Published: 2026-06-27

### [Configuring Secrets and API Keys in the Agent-Native Onboarding Checklist](/BuilderIO/agent-native/configuring-secrets-api-keys-agent-native-onboarding)

Easily configure API keys and secrets in the Agent-Native onboarding checklist using registerRequiredSecret() in a Nitro plugin. Streamline your setup process.

- Tags: how-to-guide
- Published: 2026-06-27

### [Implementing Optimistic UI Updates with useDbSync Polling in Agent-Native](/BuilderIO/agent-native/optimistic-ui-updates-usedbsync-polling-agent-native)

Learn to implement optimistic UI updates in Agent-Native using useDbSync polling and TanStack Query. Achieve instant local state changes and prevent stale data overwrites with version cursors.

- Tags: how-to-guide
- Published: 2026-06-27

### [Adding shadcn/ui Components to Agent-Native: The Complete Design System Guide](/BuilderIO/agent-native/adding-shadcn-ui-components-agent-native-design-system)

Integrate shadcn/ui components into Agent-Native easily. Follow our guide to add components using the shadcn CLI and maintain design system consistency with React 19 and Vite.

- Tags: how-to-guide
- Published: 2026-06-27

### [Using Drizzle ORM with Agent-Native Portable Schema Patterns](/BuilderIO/agent-native/using-drizzle-orm-agent-native-portable-schema)

Learn how to use Drizzle ORM with Agent-Native's portable schema patterns for SQLite, Postgres, and Neon. Write a single schema and enforce additive migrations.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Implement the A2A Protocol for Agent-to-Agent Communication in Agent-Native](/BuilderIO/agent-native/how-to-implement-a2a-protocol-agent-to-agent-communication-agent-native)

Learn to implement the A2A protocol for agent-to-agent communication in Agent-Native. Use mountA2A and callAgent() to enable seamless inter-app actions.

- Tags: how-to-guide
- Published: 2026-06-27

### [Setting Up Recurring Background Jobs with Cron in Agent-Native](/BuilderIO/agent-native/setting-up-recurring-background-jobs-cron-agent-native)

Effortlessly set up recurring background jobs with cron in Agent-Native. Configure schedules in wrangler.toml and implement job logic to automate tasks.

- Tags: how-to-guide
- Published: 2026-06-27

### [Creating Sandboxed Alpine.js Extensions Stored in SQL for Agent-Native](/BuilderIO/agent-native/creating-sandboxed-alpine-js-extensions-sql-agent-native)

Learn how agent native securely stores and runs sandboxed Alpine.js extensions in SQL. Explore mini-apps validated against a safe directive whitelist and rendered in isolated iframes with CSP.

- Tags: how-to-guide
- Published: 2026-06-27

### [Implementing Context-Awareness for Agent-Native: How the Agent Knows the User's View](/BuilderIO/agent-native/implementing-context-awareness-agent-native-user-view)

Learn how to implement context awareness for agent native. Query user views via standardized memory APIs with real-time UI state and server-side sync.

- Tags: how-to-guide
- Published: 2026-06-27

### [Building Real-Time Collaborative Editing with Yjs CRDT in Agent-Native](/BuilderIO/agent-native/building-real-time-collaborative-editing-yjs-crdt-agent-native)

Build real-time collaborative editing with Yjs CRDT in Agent-Native. Learn how Agent-Native uses SQL persistence, client-side hooks, and server-side caching for seamless synchronization.

- Tags: tutorial
- Published: 2026-06-27

### [Using Agent-Native Audit Log to Track Agent vs Human Mutations](/BuilderIO/agent-native/using-agent-native-audit-log-track-mutations)

Learn how to use the Agent Native audit log to track agent vs human mutations. This built-in subsystem automatically records data changes, identifying the caller and the run.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Configure MCP Apps with Inline iframe Rendering in Agent-Native](/BuilderIO/agent-native/how-to-configure-mcp-apps-inline-iframe-agent-native)

Learn how to configure MCP Apps with inline iframe rendering in agent-native. Mount the MCP server plugin, expose iframeTitle, and detect the embed surface on the client.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Implement Human-in-the-Loop Action Approval in Agent-Native](/BuilderIO/agent-native/implementing-human-in-the-loop-agent-native-action-approval)

Learn to implement human-in-the-loop action approval in Agent-Native. Set needsApproval true to pause execution and require a human reviewer for action confirmation.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Expose Zod-Validated Actions to the Agent in Agent-Native](/BuilderIO/agent-native/how-to-expose-zod-actions-to-agent-native-agent)

Learn how to expose Zod validated actions to the agent in Agent-Native. Use defineAction with Zod schemas and expose them for agent invocation. Get started now.

- Tags: how-to-guide
- Published: 2026-06-27

### [How to Define Actions with Standard Schema (Zod) for Agent-Native](/BuilderIO/agent-native/how-to-define-actions-with-zod-for-agent-native)

Learn how to define actions with Standard Schema Zod in Agent-Native. Import defineAction, provide Zod schema, and implement the async handler for typed input and validation.

- Tags: how-to-guide
- Published: 2026-06-27

### [Where to Find Agent-Native Example Code: Templates and Samples Explained](/BuilderIO/agent-native/where-can-i-find-example-code-for-agent-native)

Find agent-native example code in the BuilderIO/agent-native repository. Explore full-stack templates like Calendar Mail and Video or minimal defineAction samples in the README.

- Tags: getting-started
- Published: 2026-06-21

### [Common Use Cases for Agent-Native: Building Agent-First Applications with Shared State](/BuilderIO/agent-native/what-are-the-common-use-cases-for-agent-native)

Discover common use cases for Agent-Native, a framework for building agent-first apps. Share data, actions, and UI for SaaS, internal tools, chat apps, and self-improving systems.

- Tags: use-cases
- Published: 2026-06-21

### [How to Handle Routing with Agent-Native: A Complete Guide to React Router Integration](/BuilderIO/agent-native/how-to-handle-routing-with-agent-native)

Learn how to handle routing with Agent-Native and React Router integration. Discover seamless routing across client, server, and agent runtime with this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-06-21

### [Best Practices for Using Agent-Native: Building Agent-First Applications](/BuilderIO/agent-native/what-are-the-best-practices-for-using-agent-native)

Discover best practices for Agent-Native, an open-source framework for building agent-first applications. Share data, actions, and runtime between AI agents and UIs using TypeScript and SQL.

- Tags: best-practices
- Published: 2026-06-21

### [Does Agent-Native Support iOS and Android? Complete Cross-Platform Guide](/BuilderIO/agent-native/does-agent-native-support-different-platforms-ios-android)

Discover if Agent-Native supports iOS and Android. Get the complete cross-platform guide for mobile app development with Expo and React Native. Build native binaries easily.

- Tags: how-to-guide
- Published: 2026-06-21

### [How to Manage Components with Agent-Native: Import, Create, and Register UI Building Blocks](/BuilderIO/agent-native/how-to-manage-components-with-agent-native)

Learn to manage components with Agent-Native. Import, create, and register UI building blocks easily without extra build steps. Streamline your development workflow today.

- Tags: how-to-guide
- Published: 2026-06-21

### [What Is the Underlying Technology of Agent-Native? A Full-Stack TypeScript Framework Explained](/BuilderIO/agent-native/what-is-the-underlying-technology-of-agent-native)

Discover the underlying technology of Agent-Native a full-stack TypeScript framework. Explore Node.js Hono Drizzle ORM libSQL and React for self-hosted agent loops with type-safe actions.

- Tags: deep-dive
- Published: 2026-06-21

### [How to Contribute to Agent-Native: A Complete Guide for Open Source Developers](/BuilderIO/agent-native/how-to-contribute-to-agent-native)

Learn how to contribute to Agent Native for open source development. Follow our guide to fork, install, code, test, and submit your pull request to the BuilderIO Agent Native repo.

- Tags: how-to-guide
- Published: 2026-06-21

### [Performance Implications of Using Agent-Native: SQL Indexes, Action APIs, and Real-Time Sync](/BuilderIO/agent-native/what-are-the-performance-implications-of-using-agent-native)

Explore agent-native performance: Discover how indexed SQL tables, unified action APIs, and real-time sync boost speed. Learn about index maintenance for write-heavy loads.

- Tags: performance
- Published: 2026-06-21

### [How to Update Agent-Native: A Complete Guide to the Monorepo Workflow](/BuilderIO/agent-native/how-to-update-agent-native)

Easily update your Agent-Native monorepo: pull the main branch, reinstall dependencies, run prep, and upgrade the CLI. Follow this guide for a smooth process.

- Tags: how-to-guide
- Published: 2026-06-21

### [Agent-Native Limitations: 7 Critical Constraints Developers Must Know](/BuilderIO/agent-native/what-are-the-limitations-of-agent-native)

Explore the agent-native limitations developers must know. Understand constraints like additive-only migrations and single-author editing to build effectively.

- Tags: deep-dive
- Published: 2026-06-21

### [Can Agent-Native Be Used for Mobile App Development? A Complete Guide](/BuilderIO/agent-native/can-agent-native-be-used-for-mobile-app-development)

Explore if Agent-Native powers mobile app development. Learn how this web-first framework leverages PWAs and responsive design for mobile web apps, though it lacks a native SDK.

- Tags: getting-started
- Published: 2026-06-21

### [How Agent-Native Handles Dynamic Content: SSR, Route Discovery, and Runtime Loading](/BuilderIO/agent-native/how-does-agent-native-handle-dynamic-content)

Agent-Native efficiently manages dynamic content using SSR, lazy imports, and client-side recovery. Discover how its architecture optimizes API route discovery and runtime loading for better performance.

- Tags: deep-dive
- Published: 2026-06-21

### [Prerequisites for Using Agent-Native: Node.js and pnpm Setup Guide](/BuilderIO/agent-native/what-are-the-prerequisites-for-using-agent-native)

Set up Node.js v24+ and pnpm v10+ for Agent-Native. This guide covers the essential prerequisites for running the Agent-Native monorepo framework and development server smoothly.

- Tags: getting-started
- Published: 2026-06-21

### [Are There Builder.io SDKs for Native Apps? A Complete Guide to Agent-Native](/BuilderIO/agent-native/are-there-specific-builder-io-sdks-for-native-apps)

Integrate Builder.io into iOS and Android apps with the official React Native SDK. Explore the Agent-Native guide for seamless native app experiences.

- Tags: getting-started
- Published: 2026-06-21

### [How to Configure Agent-Native: Environment Variables, Templates, and CLI Setup](/BuilderIO/agent-native/how-to-configure-agent-native)

Configure Agent-Native effortlessly. Set up environment variables, templates, and CLI for your project. Get started with Builder.io Agent-Native today.

- Tags: how-to-guide
- Published: 2026-06-21

### [What Is the Agent-Native API? A Unified Interface for UI, Server, and AI Agents](/BuilderIO/agent-native/what-is-the-agent-native-api)

Explore the agent-native API a unified interface for UI, server, and AI agents. Simplify operations with a single abstraction and Zod schema integration.

- Tags: what-is
- Published: 2026-06-21

### [How to Integrate Agent-Native into a React Native Project: Complete Implementation Guide](/BuilderIO/agent-native/how-to-integrate-agent-native-into-a-react-native-project)

Learn how to integrate Agent-Native into your React Native app. Explore direct server actions or WebView embedding for a seamless implementation.

- Tags: how-to-guide
- Published: 2026-06-21

### [Core Components of Agent‑Native: A Complete Architecture Guide](/BuilderIO/agent-native/what-are-the-core-components-of-agent-native)

Explore the four core components of Agent Native architecture: Actions, Agent Runtime, SQL persistence, and a React frontend. Unify AI agents with full-stack apps seamlessly.

- Tags: architecture
- Published: 2026-06-21

### [How to Use Builder.io with Agent-Native: Complete Integration Guide](/BuilderIO/agent-native/how-to-use-builder-io-with-agent-native)

Integrate Builder.io with Agent-Native effortlessly. Learn how to enable file uploads and leverage storage capabilities with our complete guide. Get started now.

- Tags: how-to-guide
- Published: 2026-06-21

### [What Is the Main Entry Point for Agent-Native? (BuilderIO/agent-native)](/BuilderIO/agent-native/what-is-the-main-entry-point-for-agent-native)

Discover the main entry point for Agent-Native. Learn how the createServer function from @agent-native/core initializes your H3 server with essential middleware for seamless development.

- Tags: getting-started
- Published: 2026-06-21

### [How to Install Agent-Native: Complete Setup Guide for the BuilderIO Monorepo](/BuilderIO/agent-native/how-to-install-agent-native)

Install Agent-Native easily with this comprehensive setup guide. Clone the repo, run pnpm install, and launch the dev server to get started with the BuilderIO monorepo.

- Tags: getting-started
- Published: 2026-06-21