agent

examples/agent

Minimal computer-use demo using portabledesktop, portabledesktop/ai, and Vercel AI SDK.

What it does

1. Starts a desktop session.
2. Starts a live VNC viewer and opens it in your host browser.
3. Runs the agent for your --prompt and streams text to stdout as it arrives.
4. Saves an MP4 recording and opens that MP4 in your host browser.

Setup

cd examples/agent
bun install

Set ANTHROPIC_API_KEY in repo-root .env.local or your shell. For OpenAI tests, set OPENAI_API_KEY.

Run

bun run start -- --prompt "Open coder.com and find the Dropbox customer story"

Run with OpenAI:

bun run start -- --provider openai --model gpt-5 --prompt "Open coder.com and find the Dropbox customer story"

or:

bun run smoke:openai

If --prompt is omitted, a default web-navigation prompt is used.

Notes

• The example launches a desktop browser automatically.
• Recordings are saved under examples/agent/tmp/.
• Idle segments in the recording are auto-sped up for demo readability.