Run Agents

Studio

Inspect a developer-owned agent server through a loopback-only local dashboard.

@nylorun/studio serves static UI assets for local inspection. It does not load agent code, proxy provider requests, or receive browser credentials. Your server remains the owner of agent creation, model access, storage, authentication, and policy.

npx @nylorun/studio@beta studio --agent-server-url http://127.0.0.1:4111

Run Studio and the agent server on the same development machine. Allow Studio's loopback origin in your server's CORS configuration; do not expose a development server or Studio itself as an unauthenticated public service.

Server contract

Studio discovers and inspects agents through these server endpoints:

EndpointPurpose
GET /v1/agentsAgent IDs and manifest URLs
GET /agents/:id/manifest.jsonOne public agent manifest
POST /agents/:id/v1/ag-uiAG-UI Server-Sent Events run stream
GET/POST /agents/:id/v1/sessions/...Sessions, canonical events, history, and approvals

The Studio package exports dependency-free discovery and manifest types for implementing this contract. Keep keys, cookies, headers, and raw provider payloads out of Studio configuration, manifests, and events.

Start from the public example

After configuring a provider, run the example's server and Studio together:

npm run build
npm run studio

Studio lets you choose an agent, inspect its manifest, run sessions, review approvals, and see the canonical records your server produces. The example is a reference implementation, not a required application framework.

On this page