Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

chore: remove the samples/ redirect stubs (examples/ is the home) (#6020)

cua-agents[bot]76d8260e0997
diff --git a/.github/scripts/tests/test_sync_sdk_release_locks.py b/.github/scripts/tests/test_sync_sdk_release_locks.py
index cebfc6ad7b..cb8a66d764 100644
--- a/.github/scripts/tests/test_sync_sdk_release_locks.py
+++ b/.github/scripts/tests/test_sync_sdk_release_locks.py
@@ -26,11 +26,11 @@ def repo(tmp_path: Path) -> Path:
"libs/c/uv.lock": uv_package("cua-sandbox", "0.4.1", 'editable = "."'),
# The SDK's own lock is Release Please's.
"libs/cua/typescript/package-lock.json": '{\n "packages": {\n "": {\n "version": "0.4.1"\n }\n }\n}\n',
- "samples/ts/package-lock.json": '{\n "packages": {\n "": {\n "version": "1.0.0"\n },\n'
+ "examples/ts/package-lock.json": '{\n "packages": {\n "": {\n "version": "1.0.0"\n },\n'
+ sdk_entry
+ ' "node_modules/x": {\n "version": "0.4.1"\n }\n }\n}\n',
# A registry install of the SDK is not a link to the checkout.
- "samples/other/package-lock.json": json.dumps(
+ "examples/other/package-lock.json": json.dumps(
{"packages": {"": {}, "node_modules/@trycua/cua": {"version": "0.4.1"}}}, indent=2
),
}
@@ -48,21 +48,21 @@ def test_only_the_recorded_sdk_version_changes(repo: Path, capsys: pytest.Captur
assert main(["--repo-root", str(repo)]) == 0
- assert capsys.readouterr().out.split() == ["libs/a/uv.lock", "uv.lock", "samples/ts/package-lock.json"]
+ assert capsys.readouterr().out.split() == ["libs/a/uv.lock", "uv.lock", "examples/ts/package-lock.json"]
changed = {p for p, text in before.items() if p.read_text() != text}
- assert changed == {repo / "uv.lock", repo / "libs/a/uv.lock", repo / "samples/ts/package-lock.json"}
+ assert changed == {repo / "uv.lock", repo / "libs/a/uv.lock", repo / "examples/ts/package-lock.json"}
for path in changed:
assert path.read_text() == before[path].replace('"0.4.1"', '"0.5.0"', 1)
# The lock revision is not rewritten, and a dependency at the old version stays.
assert "revision = 3" in (repo / "uv.lock").read_text()
- assert '"node_modules/x": {\n "version": "0.4.1"' in (repo / "samples/ts/package-lock.json").read_text()
+ assert '"node_modules/x": {\n "version": "0.4.1"' in (repo / "examples/ts/package-lock.json").read_text()
assert main(["--repo-root", str(repo)]) == 0
assert capsys.readouterr().out.strip() == ""
def test_an_unrecognised_sdk_link_fails_loudly(repo: Path) -> None:
- lock = repo / "samples/ts/package-lock.json"
+ lock = repo / "examples/ts/package-lock.json"
data = json.loads(lock.read_text())
lock.write_text(json.dumps(data, separators=(",", ":")))
with pytest.raises(RuntimeError, match="expected one version"):
@@ -96,7 +96,7 @@ def test_cargo_locks_follow_the_published_sdk_crates(tmp_path: Path, capsys: pyt
# The workspace's own lock: Release Please does not bump it.
"libs/cua/Cargo.lock": "version = 4\n\n" + crate("cua-proto", "0.5.0"),
# From crates.io, and another workspace crate: left alone.
- "samples/x/Cargo.lock": "version = 4\n\n" + crate("cua-proto", "0.5.0", registry) + "\n" + crate("cua-sdk", "0.1.0"),
+ "examples/x/Cargo.lock": "version = 4\n\n" + crate("cua-proto", "0.5.0", registry) + "\n" + crate("cua-sdk", "0.1.0"),
}
for rel, content in files.items():
path = tmp_path / rel
@@ -104,7 +104,7 @@ def test_cargo_locks_follow_the_published_sdk_crates(tmp_path: Path, capsys: pyt
path.write_text(content)
subprocess.run(["git", "init", "-q"], cwd=tmp_path, check=True)
subprocess.run(["git", "add", "-A"], cwd=tmp_path, check=True)
- before = (tmp_path / "samples/x/Cargo.lock").read_text()
+ before = (tmp_path / "examples/x/Cargo.lock").read_text()
assert main(["--repo-root", str(tmp_path)]) == 0
@@ -112,4 +112,4 @@ def test_cargo_locks_follow_the_published_sdk_crates(tmp_path: Path, capsys: pyt
assert '"0.5.0"' not in (tmp_path / "libs/cua/Cargo.lock").read_text()
spacesd = (tmp_path / "libs/cua-spacesd/Cargo.lock").read_text()
assert spacesd.count('version = "0.6.0"') == 2 and '"0.5.0"' not in spacesd
- assert (tmp_path / "samples/x/Cargo.lock").read_text() == before
+ assert (tmp_path / "examples/x/Cargo.lock").read_text() == before
diff --git a/.github/workflows/ci-openkoalabot-example-tauri.yml b/.github/workflows/ci-openkoalabot-example-tauri.yml
index 1b490abb4a..aed88da871 100644
--- a/.github/workflows/ci-openkoalabot-example-tauri.yml
+++ b/.github/workflows/ci-openkoalabot-example-tauri.yml
@@ -17,7 +17,7 @@ on:
push:
branches: [main]
paths:
- - "samples/openkoalabot-example-tauri/**"
+ - "examples/openkoalabot-example-tauri/**"
- "libs/cua/**"
- "libs/cua-spacesd/**"
- ".github/workflows/ci-openkoalabot-example-tauri.yml"
diff --git a/docs/public/img/SOURCES.md b/docs/public/img/SOURCES.md
index 18c63c81b6..7fea78d1a7 100644
--- a/docs/public/img/SOURCES.md
+++ b/docs/public/img/SOURCES.md
@@ -24,31 +24,31 @@ Commands ran with `HOME` pointed at an empty scratch dir so only sandboxes creat
- `spaces/spaces-settings.png` | the Settings page (agent list detected under the temp HOME) | apps/cua-spaces at wt/kvui 2988b18f9 (decluttered UI), `pnpm tauri build --debug --bundles app`, ad hoc signed; temp HOME and CUA_HOME, file credential store; a debug `cua daemon` from the same commit with `CUA_KEYVAULT_TEST_REQUIREMENT` naming this app build by cdhash (no login keychain touched); a local capture harness | `CUA_SPACES_START_VIEW=settings` | `screencapture -o -l <window id>` | 2026-09-25T02:04Z
- `spaces/spaces-viewer.png` | the Space viewer window opened through the app's loopback control server (`POST /viewer/open`), live desktop stream of a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-kvui-space`), added with `cua spaces add 127.0.0.1:<port> --token ... --name aurora` | apps/cua-spaces at wt/kvui 2988b18f9 (decluttered UI), `pnpm tauri build --debug --bundles app`, ad hoc signed; temp HOME and CUA_HOME, file credential store; a debug `cua daemon` from the same commit with `CUA_KEYVAULT_TEST_REQUIREMENT` naming this app build by cdhash (no login keychain touched); a local capture harness | as described | `screencapture -o -l <window id>` of the viewer window | 2026-09-25T02:05Z
- `spaces/spaces-menu-bar-icon.png` | the Cua Spaces menu bar item (stacked-mark template icon) | apps/cua-spaces at wt/kvui 2988b18f9 (decluttered UI), `pnpm tauri build --debug --bundles app`, ad hoc signed; temp HOME and CUA_HOME, file credential store; a debug `cua daemon` from the same commit with `CUA_KEYVAULT_TEST_REQUIREMENT` naming this app build by cdhash (no login keychain touched); a local capture harness | app launched with no start view | `screencapture -o -l <status item window id>` (that item's own window, listed as Item-0 and gone when the app quit) | 2026-09-25T02:06Z
-- `openkoalabots/openkoalabots-swift-thread.png` | samples/openkoalabot-example-swift at wt/okbui a9a40d8a7, a real agent thread: Bot Ada (created by the app, its Claude Code run installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --scripts` (replies chosen by prompt text: a greeting, then for "Please check the memory on your computer." a `cua-driver` click and `type_text` of `free -h` into the terminal and a reply); the transcript comes from the SDK's `AgentTranscript` over `agent_events`: install progress, the tool calls and the turn ends are muted activity groups (the tool group opened), messages are prose; next to the Computer pane; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address (`direct:127.0.0.1:34802`) to a temp embedded registry, with an xfce4-terminal, Firefox, xcalc and the CUA Fixture Grid open; the window list shows the guest desktop's own app icons from the SDK's `Space.appIcon` (none for xcalc and the fixture grid, which have no desktop entry); temp HOME and CUA_HOME, hermetic data dir, dark appearance | Swift 6.3.3, debug `swift build`, cua-sdk release dylib from the same commit | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:34802 OPENKOALABOTS_MODEL_URL=http://<mock>:18787 OPENKOALABOTS_MODEL=claude-mock-1 ANTHROPIC_API_KEY=<mock key> OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_THREAD_CAPTURE=<dir> .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of the app window only (the capture mode's own call) | 2026-09-26T07:44Z
-- `openkoalabots/openkoalabots-swift-new-space.png` | samples/openkoalabot-example-swift at wt/kvui 2988b18f9, fixture data (demo identity), design-capture stage `wizard` (New Space sheet, step 1), light appearance, temp HOME, hermetic data dir, offline (no Space call) | Swift 6.3.3 (swiftlang-6.3.3.1.3), debug `swift build`, cua-sdk release dylib from the same commit | `HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_DESIGN_CAPTURE=wizard OPENKOALABOTS_APPEARANCE=light .build/debug/OpenKoalaBotExample` | `screencapture -o -l <window id>` of the app's main window only | 2026-09-25T02:09Z
-- `openkoalabots/openkoalabots-tauri-thread.png` | samples/openkoalabot-example-tauri with a real agent run: the thread built from the SDK transcript fold (agent messages as prose; install progress, tool calls and results and the turn end as muted collapsible step groups, the tool group opened by the walkthrough's `expand`) and the Computer pane's window list with app icons from `Space.app_icon` (the terminal's icon from the guest's icon theme; XCalc and the fixture grid have none, so they show none); a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address; the Claude Code harness (claude-agent-acp 0.81.1, claude-code 2.1.281, installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --scripts` (a rule matched on the prompt text clicks the terminal and types `free -h` through cua-driver, then replies), no real model | wt/okbui 2fe81be45, `pnpm tauri build --debug --no-bundle`, the sample's `OPENKOALABOTS_WALKTHROUGH` demo, temp HOME and CUA_HOME | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<json: the Space by address, dark theme, Bot Koala says "Please check the memory on your computer.", computer open, expand "Tool"> OPENKOALABOTS_MODEL_URL=<mock> OPENKOALABOTS_MODEL=claude-mock-1 OPENKOALABOTS_MODEL_KEY_VAR=ANTHROPIC_API_KEY ANTHROPIC_API_KEY=<mock key> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of the app window only (id from CGWindowList filtered by the app's pid) | 2026-09-26T07:36Z
-- `openkoalabots/openkoalabots-ts-new-space.png` | samples/openkoalabot-example-ts web UI at wt/kvui 2988b18f9, local server with the embedded runtime, temp HOME and empty `--home` (no Bots, no Space), no Fleet credentials, New Space sheet open (step 1), light color scheme | Node 26.9.0, Vite 6.4.3, agent-browser 0.38.1, @trycua/cua 0.2.0 (native and wasm browser build from the same commit) | `HOME=<tmp> node dist/server/main.js --port 4791 --home <tmp>`, then `agent-browser` open, viewport 1280x800, click New Space, `set media light` | `agent-browser screenshot` of the page | 2026-09-25T02:11Z
-- `openkoalabots/openkoalabots-swift-pip-desktop.png` | the desktop PiP panel (StreamPiPSet, shared session); samples/openkoalabot-example-swift at wt/okbpip 8a5b1a96e, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbpip`) added by address to a temp embedded registry, an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3291 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of that app window or PiP panel only | 2026-09-25T04:07Z
-- `openkoalabots/openkoalabots-swift-pip-window.png` | a per-window PiP panel for the "Build log" terminal (its own session); samples/openkoalabot-example-swift at wt/okbpip 8a5b1a96e, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbpip`) added by address to a temp embedded registry, an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3291 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of that app window or PiP panel only | 2026-09-25T04:07Z
-- `openkoalabots/openkoalabots-swift-computer.png` | the main window's Computer pane with the desktop popped out, the window list with app icons and the drop zone; samples/openkoalabot-example-swift at wt/okbui a9a40d8a7, a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address (`direct:127.0.0.1:34802`) to a temp embedded registry, with an xfce4-terminal, Firefox, xcalc and the CUA Fixture Grid open; the window list shows the guest desktop's own app icons from the SDK's `Space.appIcon` (none for xcalc and the fixture grid, which have no desktop entry); temp HOME and CUA_HOME, hermetic data dir, dark appearance | Swift 6.3.3, debug `swift build`, cua-sdk release dylib from the same commit; one fixture Bot (demo identity) | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:34802 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW=terminal .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of the app window only | 2026-09-26T07:45Z
-- `openkoalabots/openkoalabots-swift-takeover.png` | the full-screen takeover with the one drop zone (`TeleportDropZone`, the same as the Computer pane); samples/openkoalabot-example-swift at wt/fixes-b-samples, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesb-okb`) added by address to a temp embedded registry (`live-pip`), an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3293 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` (the tour ends on the takeover) | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T20:19Z
-- `openkoalabots/openkoalabots-tauri-pip-desktop.png` | the desktop PiP window (always on top, its own media session; no title bar and no traffic lights, like macOS's own PiP: the picture fills the window, which closes on Escape or a hover-only close button); a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesc-okb`) added by address, an xfce4-terminal "Build log" printing the time | samples/openkoalabot-example-tauri at wt/fixes-c-pip, `pnpm tauri build --debug --no-bundle` (embedded frontend, no dev server), temp HOME and CUA_HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, pip "desktop,build log"> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of that window only | 2026-09-25T23:56Z
-- `openkoalabots/openkoalabots-tauri-pip-window.png` | a per-window PiP window of the xfce4-terminal "Build log" (no title bar and no traffic lights: the picture fills the window); a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesc-okb`) added by address | samples/openkoalabot-example-tauri at wt/fixes-c-pip, `pnpm tauri build --debug --no-bundle` (embedded frontend, no dev server), temp HOME and CUA_HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, pip "desktop,build log"> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of that window only | 2026-09-25T23:56Z
-- `openkoalabots/openkoalabots-swift-presence.png` | the Computer pane with the Bot "Sales Outbound" present on the Space (joined from a separate `@trycua/cua` runtime with `agentIdentity("sales", ...)` + `updateCursor`): its cursor over the live stream is the same SDK presence color as its avatar; samples/openkoalabot-example-swift at wt/okbparity, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbparity-box`) added by address to a temp embedded registry; one fixture Bot (demo identity), temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:<port> OPENKOALABOTS_PRESENCE_CAPTURE=<dir> .build/debug/OpenKoalaBotExample`, with `node koala.mjs` (temp HOME) moving the Bot's cursor | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T22:55Z
-- `openkoalabots/openkoalabots-ts-routines.png` | samples/openkoalabot-example-ts web UI: Koala's routines panel after "Memory check" (daily at 8:30 AM) ran with Run now as a real agent turn, plus "Tidy Downloads" (every hour, off); the sidebar row previews the Bot's last message (`AgentTranscript.preview`, never a turn-end line); the Computer panel's window list shows each app's icon from the Space (`Space.appIcon`), none for apps the Space has no icon for; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address; the Claude Code harness against the scripted mock provider `cua-mock-llm` (replies chosen by prompt text; prompts carry no `mock:` directive), no real model | wt/okbui 456ee1110, Node 26.9.0, agent-browser 0.38.1, @trycua/cua (native and wasm from the same worktree) | `HOME=<tmp> ANTHROPIC_API_KEY=<mock key> node dist/server/main.js --port 4797 --home <tmp> --model-url http://<mock>:18787 --model claude-mock-1`; Space, Bot and routines created through the page's API, then `agent-browser` open, viewport 1280x800, `set media dark`, Routines | `agent-browser screenshot` of the page | 2026-09-26T07:40Z
-- `openkoalabots/openkoalabots-tauri-group-chat.png` | the group chat "Launch" with Ada and Bo, each reply attributed next to the Bot's avatar on its presence color; the sidebar rows show each Bot's latest reply; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-okbgaps-box`, runc) added by address; both Bots are real Claude Code harness runs (installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --rules` (replies chosen by prompt text, so no `mock:` directive appears in the chat) | samples/openkoalabot-example-tauri at wt/okbgaps, `pnpm tauri build --debug --no-bundle`, temp HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, Bots Ada and Bo, group "Launch" with one message> OPENKOALABOTS_MODEL_URL=<mock> OPENKOALABOTS_MODEL=claude-mock-1 OPENKOALABOTS_MODEL_KEY_VAR=ANTHROPIC_API_KEY openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T23:56Z
+- `openkoalabots/openkoalabots-swift-thread.png` | examples/openkoalabot-example-swift at wt/okbui a9a40d8a7, a real agent thread: Bot Ada (created by the app, its Claude Code run installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --scripts` (replies chosen by prompt text: a greeting, then for "Please check the memory on your computer." a `cua-driver` click and `type_text` of `free -h` into the terminal and a reply); the transcript comes from the SDK's `AgentTranscript` over `agent_events`: install progress, the tool calls and the turn ends are muted activity groups (the tool group opened), messages are prose; next to the Computer pane; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address (`direct:127.0.0.1:34802`) to a temp embedded registry, with an xfce4-terminal, Firefox, xcalc and the CUA Fixture Grid open; the window list shows the guest desktop's own app icons from the SDK's `Space.appIcon` (none for xcalc and the fixture grid, which have no desktop entry); temp HOME and CUA_HOME, hermetic data dir, dark appearance | Swift 6.3.3, debug `swift build`, cua-sdk release dylib from the same commit | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:34802 OPENKOALABOTS_MODEL_URL=http://<mock>:18787 OPENKOALABOTS_MODEL=claude-mock-1 ANTHROPIC_API_KEY=<mock key> OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_THREAD_CAPTURE=<dir> .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of the app window only (the capture mode's own call) | 2026-09-26T07:44Z
+- `openkoalabots/openkoalabots-swift-new-space.png` | examples/openkoalabot-example-swift at wt/kvui 2988b18f9, fixture data (demo identity), design-capture stage `wizard` (New Space sheet, step 1), light appearance, temp HOME, hermetic data dir, offline (no Space call) | Swift 6.3.3 (swiftlang-6.3.3.1.3), debug `swift build`, cua-sdk release dylib from the same commit | `HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_DESIGN_CAPTURE=wizard OPENKOALABOTS_APPEARANCE=light .build/debug/OpenKoalaBotExample` | `screencapture -o -l <window id>` of the app's main window only | 2026-09-25T02:09Z
+- `openkoalabots/openkoalabots-tauri-thread.png` | examples/openkoalabot-example-tauri with a real agent run: the thread built from the SDK transcript fold (agent messages as prose; install progress, tool calls and results and the turn end as muted collapsible step groups, the tool group opened by the walkthrough's `expand`) and the Computer pane's window list with app icons from `Space.app_icon` (the terminal's icon from the guest's icon theme; XCalc and the fixture grid have none, so they show none); a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address; the Claude Code harness (claude-agent-acp 0.81.1, claude-code 2.1.281, installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --scripts` (a rule matched on the prompt text clicks the terminal and types `free -h` through cua-driver, then replies), no real model | wt/okbui 2fe81be45, `pnpm tauri build --debug --no-bundle`, the sample's `OPENKOALABOTS_WALKTHROUGH` demo, temp HOME and CUA_HOME | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<json: the Space by address, dark theme, Bot Koala says "Please check the memory on your computer.", computer open, expand "Tool"> OPENKOALABOTS_MODEL_URL=<mock> OPENKOALABOTS_MODEL=claude-mock-1 OPENKOALABOTS_MODEL_KEY_VAR=ANTHROPIC_API_KEY ANTHROPIC_API_KEY=<mock key> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of the app window only (id from CGWindowList filtered by the app's pid) | 2026-09-26T07:36Z
+- `openkoalabots/openkoalabots-ts-new-space.png` | examples/openkoalabot-example-ts web UI at wt/kvui 2988b18f9, local server with the embedded runtime, temp HOME and empty `--home` (no Bots, no Space), no Fleet credentials, New Space sheet open (step 1), light color scheme | Node 26.9.0, Vite 6.4.3, agent-browser 0.38.1, @trycua/cua 0.2.0 (native and wasm browser build from the same commit) | `HOME=<tmp> node dist/server/main.js --port 4791 --home <tmp>`, then `agent-browser` open, viewport 1280x800, click New Space, `set media light` | `agent-browser screenshot` of the page | 2026-09-25T02:11Z
+- `openkoalabots/openkoalabots-swift-pip-desktop.png` | the desktop PiP panel (StreamPiPSet, shared session); examples/openkoalabot-example-swift at wt/okbpip 8a5b1a96e, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbpip`) added by address to a temp embedded registry, an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3291 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of that app window or PiP panel only | 2026-09-25T04:07Z
+- `openkoalabots/openkoalabots-swift-pip-window.png` | a per-window PiP panel for the "Build log" terminal (its own session); examples/openkoalabot-example-swift at wt/okbpip 8a5b1a96e, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbpip`) added by address to a temp embedded registry, an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3291 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of that app window or PiP panel only | 2026-09-25T04:07Z
+- `openkoalabots/openkoalabots-swift-computer.png` | the main window's Computer pane with the desktop popped out, the window list with app icons and the drop zone; examples/openkoalabot-example-swift at wt/okbui a9a40d8a7, a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address (`direct:127.0.0.1:34802`) to a temp embedded registry, with an xfce4-terminal, Firefox, xcalc and the CUA Fixture Grid open; the window list shows the guest desktop's own app icons from the SDK's `Space.appIcon` (none for xcalc and the fixture grid, which have no desktop entry); temp HOME and CUA_HOME, hermetic data dir, dark appearance | Swift 6.3.3, debug `swift build`, cua-sdk release dylib from the same commit; one fixture Bot (demo identity) | `HOME=<tmp> CUA_HOME=<tmp> OPENKOALABOTS_DATA_DIR=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:34802 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW=terminal .build/debug/OpenKoalaBotExample` | `screencapture -o -x -l <window id>` of the app window only | 2026-09-26T07:45Z
+- `openkoalabots/openkoalabots-swift-takeover.png` | the full-screen takeover with the one drop zone (`TeleportDropZone`, the same as the Computer pane); examples/openkoalabot-example-swift at wt/fixes-b-samples, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesb-okb`) added by address to a temp embedded registry (`live-pip`), an xfce4-terminal "Build log" printing the time; one fixture Bot (demo identity), dark appearance, temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:3293 OPENKOALABOTS_APPEARANCE=dark OPENKOALABOTS_PIP_CAPTURE=<dir> OPENKOALABOTS_PIP_WINDOW="build log" .build/debug/OpenKoalaBotExample` (the tour ends on the takeover) | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T20:19Z
+- `openkoalabots/openkoalabots-tauri-pip-desktop.png` | the desktop PiP window (always on top, its own media session; no title bar and no traffic lights, like macOS's own PiP: the picture fills the window, which closes on Escape or a hover-only close button); a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesc-okb`) added by address, an xfce4-terminal "Build log" printing the time | examples/openkoalabot-example-tauri at wt/fixes-c-pip, `pnpm tauri build --debug --no-bundle` (embedded frontend, no dev server), temp HOME and CUA_HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, pip "desktop,build log"> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of that window only | 2026-09-25T23:56Z
+- `openkoalabots/openkoalabots-tauri-pip-window.png` | a per-window PiP window of the xfce4-terminal "Build log" (no title bar and no traffic lights: the picture fills the window); a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-fixesc-okb`) added by address | examples/openkoalabot-example-tauri at wt/fixes-c-pip, `pnpm tauri build --debug --no-bundle` (embedded frontend, no dev server), temp HOME and CUA_HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, pip "desktop,build log"> openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of that window only | 2026-09-25T23:56Z
+- `openkoalabots/openkoalabots-swift-presence.png` | the Computer pane with the Bot "Sales Outbound" present on the Space (joined from a separate `@trycua/cua` runtime with `agentIdentity("sales", ...)` + `updateCursor`): its cursor over the live stream is the same SDK presence color as its avatar; examples/openkoalabot-example-swift at wt/okbparity, a real local Space: `cua-local/linux:24.04-candidate` in a gVisor container (`cua-e2e-okbparity-box`) added by address to a temp embedded registry; one fixture Bot (demo identity), temp HOME, hermetic data dir | Swift 6.3, debug `swift build`, cua-sdk release dylib from the same worktree | `HOME=<tmp> OPENKOALABOTS_SPACES=embedded OPENKOALABOTS_SPACES_HOME=<tmp> OPENKOALABOTS_TEST_SPACE=direct:127.0.0.1:<port> OPENKOALABOTS_PRESENCE_CAPTURE=<dir> .build/debug/OpenKoalaBotExample`, with `node koala.mjs` (temp HOME) moving the Bot's cursor | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T22:55Z
+- `openkoalabots/openkoalabots-ts-routines.png` | examples/openkoalabot-example-ts web UI: Koala's routines panel after "Memory check" (daily at 8:30 AM) ran with Run now as a real agent turn, plus "Tidy Downloads" (every hour, off); the sidebar row previews the Bot's last message (`AgentTranscript.preview`, never a turn-end line); the Computer panel's window list shows each app's icon from the Space (`Space.appIcon`), none for apps the Space has no icon for; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-canvas-linux`) added by address; the Claude Code harness against the scripted mock provider `cua-mock-llm` (replies chosen by prompt text; prompts carry no `mock:` directive), no real model | wt/okbui 456ee1110, Node 26.9.0, agent-browser 0.38.1, @trycua/cua (native and wasm from the same worktree) | `HOME=<tmp> ANTHROPIC_API_KEY=<mock key> node dist/server/main.js --port 4797 --home <tmp> --model-url http://<mock>:18787 --model claude-mock-1`; Space, Bot and routines created through the page's API, then `agent-browser` open, viewport 1280x800, `set media dark`, Routines | `agent-browser screenshot` of the page | 2026-09-26T07:40Z
+- `openkoalabots/openkoalabots-tauri-group-chat.png` | the group chat "Launch" with Ada and Bo, each reply attributed next to the Bot's avatar on its presence color; the sidebar rows show each Bot's latest reply; a real local Space: `cua-local/linux:24.04-candidate` in a container (`cua-e2e-okbgaps-box`, runc) added by address; both Bots are real Claude Code harness runs (installed in the Space by cua-spacesd) against the scripted mock provider `cua-mock-llm --rules` (replies chosen by prompt text, so no `mock:` directive appears in the chat) | examples/openkoalabot-example-tauri at wt/okbgaps, `pnpm tauri build --debug --no-bundle`, temp HOME | `HOME=<tmp> OPENKOALABOTS_WALKTHROUGH=<file: the Space by address, dark theme, Bots Ada and Bo, group "Launch" with one message> OPENKOALABOTS_MODEL_URL=<mock> OPENKOALABOTS_MODEL=claude-mock-1 OPENKOALABOTS_MODEL_KEY_VAR=ANTHROPIC_API_KEY openkoalabot-example-tauri` | `screencapture -o -x -l <window id>` of the app window only | 2026-09-25T23:56Z
- `spaces/spaces-volume-onboarding.png` | first run, the Cua Volume page on a fresh home: the daemon's real storage (This Mac, its `volume_storage` fs path) and mount status (NFS, off), the miniature mid-loop | apps/cua-spaces-macos at wt/drive-ui (after d2686c7a5; `scripts/build-app.sh debug`, ad hoc signed) against a release `cua daemon` from the same tree; throwaway HOME and CUA_HOME in a scratch directory, file credential store, device maya-mbp; a local capture harness | `CUA_SPACES_START_VIEW=onboarding-drive`, light appearance | `screencapture -o -l <window id>` of the app window only | 2026-09-30
- `spaces/spaces-volume-bucket-prompt.png` | first run, Your S3 bucket chosen: the agent prompt (the core's `S3_AGENT_PROMPT`) with Copy | apps/cua-spaces-macos at wt/drive-ui (after d2686c7a5; `scripts/build-app.sh debug`, ad hoc signed) against a release `cua daemon` from the same tree; throwaway HOME and CUA_HOME in a scratch directory, file credential store, device maya-mbp; a local capture harness | `CUA_SPACES_START_VIEW=onboarding-drive-bucket` | `screencapture -o -l <window id>` of the app window only | 2026-09-30
- `spaces/spaces-settings-storage.png` | Settings, Storage with an S3-compatible bucket (a local MinIO container, versioning on, keys saved through `cua volume config set-keys` into the file credential store) and the volume in Finder at the home's `~/Cua Volume` | apps/cua-spaces-macos at wt/drive-ui (after d2686c7a5; `scripts/build-app.sh debug`, ad hoc signed) against a release `cua daemon` from the same tree; throwaway HOME and CUA_HOME in a scratch directory, file credential store, device maya-mbp; a local capture harness | `CUA_SPACES_START_VIEW=settings-storage` | `screencapture -o -l <window id>` of the Settings window only | 2026-09-30
-- `cua-bots/cua-bots-mac-new-bot-look.png` | New bot, step 2: designing Ada's face | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-research-ready.png` | Ada's finished research: result card, the in-window notification, profile with Activity and Outputs | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-computer.png` | Ada's computer: the bot's Space streamed live beside the chat, Ada in control | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-scheduled.png` | the Scheduled page with Ada's daily routine | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-approval.png` | an approval card: Ada asks before buying | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-sign-in.png` | the sign-in sheet for github.com (no daemon Keyvault in the throwaway home, so it offers take over) | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-rules.png` | the custom rules sheet | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-mac-memory.png` | Ada's memory sheet and the files in her Volume home | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
-- `cua-bots/cua-bots-phone-approval.png` | the iPhone screens in the macOS preview host (`CuaBotsPhonePreview`, phone-sized window) approving the same purchase against the same bot | samples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-new-bot-look.png` | New bot, step 2: designing Ada's face | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-research-ready.png` | Ada's finished research: result card, the in-window notification, profile with Activity and Outputs | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-computer.png` | Ada's computer: the bot's Space streamed live beside the chat, Ada in control | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-scheduled.png` | the Scheduled page with Ada's daily routine | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-approval.png` | an approval card: Ada asks before buying | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-sign-in.png` | the sign-in sheet for github.com (no daemon Keyvault in the throwaway home, so it offers take over) | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-rules.png` | the custom rules sheet | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-mac-memory.png` | Ada's memory sheet and the files in her Volume home | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
+- `cua-bots/cua-bots-phone-approval.png` | the iPhone screens in the macOS preview host (`CuaBotsPhonePreview`, phone-sized window) approving the same purchase against the same bot | examples/cua-bots-macos at wt/bots-feature (on 3424ee5ad), Cua Spaces app export (`cua-spaces-ffi`) release build staged by `libs/spaces-app-swift/scripts/stage-library.sh`, a real local Space (`Image.linux()`, container under Colima), Claude Code harness against the scripted `cua-mock-llm` (`scripts/demo-model.json`), throwaway HOME and CUA_HOME, neutral identity (CUA_BOTS_OWNER=Maya, CUA_BOTS_DEVICE_NAME=maya-mbp), light appearance | `scripts/capture.sh <out> <scratch-home> --phone` | the app's capture tour, `screencapture -l <window>`, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
- `../videos/cua-bots-launch.mp4` and `../videos/cua-bots-launch.jpg` | the Cua Bots launch film (`cua-koala.mp4`, 23.4 s, 1920x1080 at 60 fps); its app screens are real Cua Bots screenshots | ffmpeg 9.0.2 | `ffmpeg -i cua-koala.mp4 -vf fps=30,format=yuv420p -c:v libx264 -preset slow -crf 23 -profile:v high -level 4.1 -movflags +faststart -c:a aac -b:a 128k cua-bots-launch.mp4`; poster: `ffmpeg -ss 3 -i cua-koala.mp4 -frames:v 1 -q:v 3 cua-bots-launch.jpg` | web encode of the final cut, no edits | 2026-09-30
- `spaces/spaces-volume-page.png` | the Volume page (status only): Open in Finder with the mount point, two devices (maya-mbp and maya-linux) sharing one versioned S3-compatible bucket, and a real conflict made by writing public/plan.md through both mounted volumes at once | the Cua Spaces macOS app (SwiftUI, debug build) against a release `cua daemon` of the same build, for each device; throwaway home folders, file credential store, a local MinIO container as the bucket | `CUA_SPACES_START_VIEW=drive`, light appearance | window capture of the app window only | 2026-09-30
- `spaces/spaces-new-space-gpu.png` | New Space, Resources step with `ghcr.io/trycua/macos:26` on this Mac: the GPU acceleration (Experimental) checkbox and Learn more from the SDK's real `gpu_support` (Lume, Apple silicon); nothing created | apps/cua-spaces-macos at wt/create-ux (on f0a686ec0 plus the core's binary-unit transfer text and steady Cancel label; `scripts/build-app.sh debug`, ad hoc signed, `scripts/check-launch.sh` passed) with the Cua Spaces app export and `cua` (release) from the same tree; its own `cua daemon`; throwaway HOME and CUA_HOME in a scratch directory, file credential store, not signed in | `CUA_SPACES_START_VIEW=new-space-resources CUA_SPACES_WIZARD_IMAGE=ghcr.io/trycua/macos:26`, light appearance (`-NSRequiresAquaSystemAppearance YES`), the window made active once (`NSRunningApplication.activate`) | `screencapture -o -l <window id>` of the app window only, unedited; OCR-checked for real names, hosts and emails | 2026-09-30
diff --git a/samples/README.md b/samples/README.md
deleted file mode 100644
index 035361c0f4..0000000000
--- a/samples/README.md
+++ /dev/null
@@ -1 +0,0 @@
-The samples moved to [examples/](../examples/). Old links to `samples/<name>` land on a stub that points to `examples/<name>`.
diff --git a/samples/cua-bots-ios/README.md b/samples/cua-bots-ios/README.md
deleted file mode 100644
index 31a8b93c20..0000000000
--- a/samples/cua-bots-ios/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/cua-bots-ios](../../examples/cua-bots-ios).
diff --git a/samples/cua-bots-macos/README.md b/samples/cua-bots-macos/README.md
deleted file mode 100644
index 93bb4fe741..0000000000
--- a/samples/cua-bots-macos/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/cua-bots-macos](../../examples/cua-bots-macos).
diff --git a/samples/driver/README.md b/samples/driver/README.md
deleted file mode 100644
index 0b089ff533..0000000000
--- a/samples/driver/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/driver](../../examples/driver).
diff --git a/samples/infinite-canvas-swift/README.md b/samples/infinite-canvas-swift/README.md
deleted file mode 100644
index 705bf8c028..0000000000
--- a/samples/infinite-canvas-swift/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/infinite-canvas-swift](../../examples/infinite-canvas-swift).
diff --git a/samples/openkoalabot-example-scenario/README.md b/samples/openkoalabot-example-scenario/README.md
deleted file mode 100644
index 91dd52caac..0000000000
--- a/samples/openkoalabot-example-scenario/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/openkoalabot-example-scenario](../../examples/openkoalabot-example-scenario).
diff --git a/samples/openkoalabot-example-swift/README.md b/samples/openkoalabot-example-swift/README.md
deleted file mode 100644
index e5c9426b1c..0000000000
--- a/samples/openkoalabot-example-swift/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/openkoalabot-example-swift](../../examples/openkoalabot-example-swift).
diff --git a/samples/openkoalabot-example-tauri/README.md b/samples/openkoalabot-example-tauri/README.md
deleted file mode 100644
index 3e0bee99ba..0000000000
--- a/samples/openkoalabot-example-tauri/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/openkoalabot-example-tauri](../../examples/openkoalabot-example-tauri).
diff --git a/samples/openkoalabot-example-ts/README.md b/samples/openkoalabot-example-ts/README.md
deleted file mode 100644
index fa42bb7c76..0000000000
--- a/samples/openkoalabot-example-ts/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/openkoalabot-example-ts](../../examples/openkoalabot-example-ts).
diff --git a/samples/openkoalabots-assets/README.md b/samples/openkoalabots-assets/README.md
deleted file mode 100644
index 92c9efab12..0000000000
--- a/samples/openkoalabots-assets/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/openkoalabots-assets](../../examples/openkoalabots-assets).
diff --git a/samples/python/README.md b/samples/python/README.md
deleted file mode 100644
index 843bb89f75..0000000000
--- a/samples/python/README.md
+++ /dev/null
@@ -1 +0,0 @@
-This sample moved to [examples/python](../../examples/python).