mrkeyoor.com_
Sat 12 Sept 15:47 UTC
AI Toolsevaluationupdated 12 Sept 2026

agent-native review

Agent-Native is a TypeScript framework for applications where an AI agent and a React interface work on the same data through the same actions. It supplies chat, permissions, memory, schedules, multiple-agent delegation, database support, and several example applications so a team does not have to connect those pieces from scratch.

Verdict

Our Agent-Native checkout installed 2,631 packages, occupied 3,322 MB, and still had not finished its test run after 900 seconds. That cost can make sense for a TypeScript team building a whole agent application, because actions, UI state, permissions, data, and agent access share one model. For a chat widget or one agent workflow, use a narrower library; for side-effecting production work, add idempotency checks and validate the open duplicate-execution and MCP OAuth reports first.

We ran it

Lab card: what happened when we ran agent-nativeScreenshot of agent-native (www.agent-native.com)
Install✓ · 174s2631 packages · 3322 MB
Build✓ · 753s
Tests✗ timed out · 900sran, no count parsed
Repo18993 files~3,580,615 lines of source · 213.1 MB · 45 CI workflows

Answers from our run

Does agent-native build from source?

Dependencies installed in 174 seconds (2631 packages), and the build succeeded in 753 seconds. We cloned commit 9e2b478 into a clean Debian container with 3 CPUs and no project-specific setup.

Do agent-native's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Who should not use agent-native?

Teams that only need a chat panel in an existing app: our contributor checkout pulled 2,631 packages and occupied 3,322 MB before any provider model was used.

What are the alternatives to agent-native?

CopilotKit, assistant-ui, LangGraph.js. Our Agent-Native checkout installed 2,631 packages, occupied 3,322 MB, and still had not finished its test run after 900 seconds.

Setup2/53,322 MB install, 753-second build, and tests exceeded 900 seconds
Docs4/5Detailed architecture, environment, workspace, and guard guidance
Community4/54,737 stars and active September 2026 issue and release work
Maturity2/5Young 0.1.x framework with serious current execution reports

Who it’s for

TypeScript teams building an agent product whose work must stay visible and editable in a web interface.
Product groups that want one action contract shared by React, HTTP, MCP, A2A, the CLI, and the agent.
Organizations prepared to run PostgreSQL, authentication, model-provider credentials, and background work in production.
Developers who want full example apps for mail, content, calendars, analytics, design, or slides rather than a bare chat component.

Who it’s NOT for

Teams that only need a chat panel in an existing app: our contributor checkout pulled 2,631 packages and occupied 3,322 MB before any provider model was used.
Python-first or backend-only shops that do not want TypeScript and React to define the application layer.
Production deployments without PostgreSQL, auth secrets, and a model provider: the development guide names those as common environment requirements.
Apps where a repeated side effect is unacceptable without extra safeguards: issue 4865 reports one confirmed agent turn executing the same delegation three times.
Path-mounted workspaces that need each app exposed as its own OAuth MCP connector today: issue 4866 reports discovery being routed to Dispatch and failing.
Maintainers who require the full upstream test command to finish within 15 minutes on a 3-CPU runner: our run hit the 900-second cap.

Setup reality

Our sandbox installed 2,631 pnpm packages in 174 seconds and occupied 3,322 MB. The build succeeded in 753 seconds. Tests were still running when the 900-second limit expired, so the full suite did not produce a pass or fail result.

Repository development needs Node 22 or newer and pnpm 10 or newer. A small generated app can use local PGlite, but production uses PostgreSQL. Common settings include DATABASE_URL, auth URLs and secrets, an A2A secret, and the key for the selected model provider.

Our measurement setup used an unprivileged Node 22 Debian container with 3 CPUs, 8 GB of RAM, and no secrets. The monorepo had 45 CI workflows and no Dockerfile; tests live beside source files rather than in a top-level tests directory. The guide provides concurrency controls because parallel workspace checks can oversubscribe a machine.

One action can serve React, HTTP, MCP, A2A, and an agent

Agent-Native's best idea is simple: define a capability once, with its input schema, permission rules, HTTP details, and implementation. The AI receives that action as a tool, while React code calls the same operation through a hook. The framework can expose it through HTTP, MCP, A2A, and the command line too. That avoids the common failure where a chat agent and the visible interface use separate business logic and gradually disagree about validation or access.

Shared data and shared UI context complete the model. Work done by an agent appears in the application, while the agent can know the current page, selected record, or active view. The included surface covers chat, memory, schedules, authentication, agent teams, and background work. Fourteen named templates in the development guide cover products such as mail, calendars, content, analytics, slides, and design. This is much closer to an application framework than a thin model SDK.

What happened when we ran it

Our sandbox installed 2,631 pnpm packages in 174 seconds and used 3,322 MB on disk. Building the monorepo succeeded in 753 seconds. We measured commit 9e2b478 in an unprivileged Node 22 Debian container with 3 CPUs, 8 GB of memory, and no secrets. The checkout itself was 213.1 MB, with 18,993 files and about 3,580,615 lines of source. Those figures describe contributor setup, not the footprint of one generated application.

The test command did not finish before our 900-second cap. Its final lines showed several packages/core spec files passing, including the sharing dialog, harness runner, workspace file store, API path, and HTTP response telemetry. The tail also contained an expected retry-exhaustion log and a missing i18next-instance warning. Neither message establishes what kept the command running. A timed-out suite is unresolved, even when its last visible tests are green.

Local PGlite becomes PostgreSQL and provider secrets in production

Node 22 and pnpm 10 are the documented minimums for repository development, with Node 24 recommended. The starter command can generate a standalone chat app, and local development falls back to PGlite when DATABASE_URL is absent. Production takes a PostgreSQL database. Common environment variables also cover the authentication secret and URL, an A2A secret, and the provider key used by the chosen agent engine. The README's bring-your-own-infrastructure line is literal.

Authentication, shared records, scheduled jobs, and external agents all increase the cost of a bad boundary. The development guide describes guard scripts for cross-tenant data leaks, credential leaks, unsafe production database pushes, and unscoped ownership queries. That is good evidence that the maintainers know where failures occur. It is also a map of what adopters must understand. The framework supplies mechanisms, but each action still needs correct authorization, idempotency, secret scope, and audit behavior.

Forty-five CI workflows do not turn a 900-second timeout into a pass

Our scan found 45 CI workflow files, no Dockerfile, no top-level tests directory, and a pnpm workspace layout. Tests are colocated with source, as the log tail confirms. The development guide offers several concurrency variables because each workspace runner can otherwise size itself from the whole host and oversubscribe the CPU when jobs run together. That warning matters on a 3-CPU container like ours and on shared CI runners.

The repository build took 753 seconds after a successful 174-second install. Its postinstall phase builds packages needed by other workspaces, and the root build covers packages plus templates. A small adopter should assess the generated app separately before assuming it inherits all 3,322 MB. A contributor, however, really does own this monorepo, its desktop and mobile apps, documentation, templates, migration tools, scheduling package, control plane, and guard system.

Open reports cover triple execution and broken MCP OAuth routing

Issue 4865 reports a confirmed turn on core 0.178.1 executing the same A2A delegation 3 times after a client-side exception. The report says the same turn_id produced three completed run rows, so repeated work could duplicate external calls, generated assets, or cost. That is a serious fit problem for actions with consequences. Until the behavior is fixed and verified on your chosen version, make write actions idempotent and reconcile provider calls against your own operation identifier.

Issue 4866 concerns path-mounted workspaces. It reports that OAuth discovery for spoke-app MCP servers is routed to Dispatch, causing an invalid_request when a client connects to an individual app. The described workaround uses the Dispatch connector or a static token on clients that accept one. Teams planning separate MCP connectors for several apps on one host should reproduce that exact route before adoption. Neither issue proves every deployment fails, but both are specific current production reports.

A six-month-old 0.1.x framework is moving quickly

BuilderIO created the repository on March 12, 2026. GitHub recorded a push on September 12, 2026, 4,737 stars, and 95 combined open issues and pull requests. Release v0.1.258 arrived on September 10 and is described as a stable desktop-app release, with installers for several operating systems. The current activity is clear. So is the early version line, and a desktop release label should not be read as a stability promise for every server and workspace interface.

Agent-Native earns a trial when the product itself is an agent workspace and visible, editable output is central. Its shared-action design is more coherent than bolting a chat box onto unrelated APIs. The price is a very large contributor environment, a build measured in minutes, and a full test command that exceeded 15 minutes on our box. Start with one generated app, test destructive actions for replay, and prove the intended MCP and authentication topology before adopting the wider suite.

Alternatives

ProjectWhat it isPick it when
CopilotKit gh↗A React-centered toolkit for embedding agent interactions and shared state into applications.pick this instead when an in-app copilot is the main requirement and Agent-Native's full application system is too broad.
assistant-uiA React component library for production chat and assistant interfaces.pick this instead when you need a polished conversation surface and already own the agent backend, data, and permissions.
LangGraph.jsA TypeScript runtime for stateful agent workflows without prescribing a complete product UI.pick this instead when workflow control and durable execution matter more than shared application actions and bundled screens.

What people are saying

  1. [github-trending] BuilderIO/agent-native

Sources

  1. Agent-Native repository and README
  2. Agent-Native development guide
  3. Issue 4865 on repeated execution of one agent turn
  4. Issue 4866 on path-mounted MCP OAuth discovery

More ai tools reviews

YuE · kserve · garak · reference-video-director · keras · whisper.cpp · the whole board →