Documentation menu

Start here

Introduction Getting started Write an agent Project anatomy

Understand Ayjnt

Harness engineering Two runtimes Human interfaces How agents work Host bridge

Agent capabilities

Callable methods State & SQLite Sessions & memory Scheduling Workflows Durable execution Inter-agent RPC Sub-agents Tools

Interfaces & integrations

Browser client Routing & middleware Voice Browser tools MCP Email Observability

CLI

Command overview new dev run build compile migrate deploy

API reference

Agent AgentClient Workflow classes Local & cloud Migrations Examples

CLI

ayjnt run

Run the full local harness: Bun host, workerd agents, host bridge, and cli.ts.

Usage

example

ayjnt run [options] [-- <args for cli.ts>]

--cwd <path>
--port <n>             default 8787; 0 chooses a free port
--data-dir <path>      Durable Object persistence directory
--allow-host-writes    allow hostTool sideEffects: "write"
--allow-host-exec      allow hostTool sideEffects: "exec"

Arguments and permissions

Non-flag arguments are passed to cli.ts. Use -- when your CLI needs a flag that Ayjnt would otherwise claim.

Read-only host tools are available by default. Write and execution permissions must be granted explicitly each run.