Artifacts

Agent-created live previews — React apps, HTML pages, and static sites. Artifact router with cold-start, port pool, and idle timeout.

Agent-created previews. Agents write code, run dev servers, and pin live URLs to the dashboard. You click and see a running app.

What Are Artifacts

Artifacts are live previews created by agents. No special system needed -- agents have filesystem and terminal access. They write code, run a dev server, and pin the URL to the dashboard. You click the link and see a running React app, HTML page, or static site.

Artifact Workflow

There is no special artifact-only primitive. Agents create artifacts with the normal tool stack: filesystem writes, terminal commands, and pin for human visibility.

artifact-workflow.ts

// 1) Write files for the artifact
write_file("artifacts/landing-v2/src/App.tsx", "...")
write_file("artifacts/landing-v2/.artifact.yaml", "...")

// 2) (Optional) run build/dev command via terminal
bash("bun run dev --cwd artifacts/landing-v2")

// 3) Surface preview URL in dashboard
pin({
  action: "create",
  group: "recent",
  title: "Artifact: landing-v2",
  type: "success",
  content: "Preview: /artifacts/landing-v2/"
})

Artifact Types

Type	How Agent Creates It	Preview
`react`	Writes JSX + Vite config, runs `bun run dev`	Live iframe with HMR
`html`	Writes HTML/CSS/JS to `/artifacts/{name}/index.html`	Static file serving
`static`	Pre-built files (OpenAPI spec, SVG, docs site)	Direct file render

.artifact.yaml Format

/artifacts/landing-v2/.artifact.yaml

name: landing-v2
serve: "bun run dev --port {port}"
build: "bun install"
health: "/"
timeout: 5m

Artifact Router

The artifact router manages dev server processes with cold-start and idle-timeout. Like serverless, but for artifacts -- zero idle cost.

artifact-router-flow

Request → /artifacts/landing-v2/
  │
  ▼
Router checks registry:
  ├── Process running? → proxy to port → reset idle timer
  └── Not running?     → cold start:
                           1. Read .artifact.yaml
                           2. Run build command (bun install)
                           3. Assign port from pool (4100-4199)
                           4. Run serve command
                           5. Wait for health check
                           6. Proxy request

How to View Artifacts

terminal

# CLI — list all artifacts
$ autopilot artifacts

# CLI — open in browser
$ autopilot artifacts open landing-v2

# CLI — stop a running artifact
$ autopilot artifacts stop landing-v2

On the dashboard, artifacts appear as cards. Click to open in an iframe or fullscreen.

When Agents Create Artifacts

UI mockups -- Designer agent creates a React artifact to prototype
Landing pages -- Developer builds a complete landing page for review
Demo apps -- Quick prototype to validate an approach
Documentation sites -- Static HTML docs for an API
Content previews -- Email templates, marketing pages