@boring/agent

Agent runtime and chat UI for boring-ui apps.

pnpm add @boring/agent

What it provides

• Agent runtime — LLM conversation loop with streaming, tool calling, and three execution modes
• Tool catalog — bash, read, write, edit, grep, find, ls and more
• Chat UI — embeddable ChatPanel React component

Execution modes

| Mode | Isolation | Typical use | |---|---|---| | direct | None | Local dev | | local | bwrap process isolation | Safer Linux deployments | | vercel-sandbox | Firecracker microVM | Multi-tenant / remote |

Quickstart

import { ChatPanel } from "@boring/agent"
import { WorkspaceProvider, IdeLayout } from "@boring/workspace"

export function App() {
  return (
    <WorkspaceProvider chatPanel={ChatPanel}>
      <IdeLayout />
    </WorkspaceProvider>
  )
}

Server:

import { createAgentApp } from "@boring/agent/server"

const app = await createAgentApp({ mode: "local", workspaceRoot: process.cwd() })
await app.listen({ port: 3001 })

Model config

ANTHROPIC_API_KEY=sk-ant-...
BORING_AGENT_DEFAULT_MODEL_PROVIDER=anthropic
BORING_AGENT_DEFAULT_MODEL_ID=claude-sonnet-4-6

Package surfaces

import { ChatPanel } from "@boring/agent"           // React chat UI
import { ... } from "@boring/agent/server"          // Node/server entry
import { ... } from "@boring/agent/front"           // Frontend-only
import { ... } from "@boring/agent/shared"          // Platform-agnostic contracts

Part of boring-ui

| Package | Role | |---|---| | @boring/core | DB, auth, app factory | | @boring/workspace | Plugin system, layouts | | @boring/agent | Agent runtime + tools |