plug terminal into any coding assistant or agent

[laithrw]

• new browser subcommand: heredoc python exec + control-plane passthrough, session-optional (auto-creates browser-cli-), prints screenshot paths
• new skill subcommand: show/paths/install embedded SKILL.md into ~/.claude, ~/.codex, ~/.config/opencode, ~/.agents skill dirs
• SKILL.md at repo root, modeled on browser-harness (helpers, screenshot viewing per assistant, gotchas)
• public run_external_browser_command/script in agent crate; extracted shared preference/preflight fns so external CLI and in-session tool share heuristics
• persistent managed/cloud browsers across one-shot invocations: marker-file reattach, BROWSER_USE_TERMINAL_PERSIST_BROWSERS + BU_EXTERNAL_BROWSER_STATE_DIR
• new browser recover stop-owned-browser (+ help text), silence kill noise
• screenshots capped at 1800px on external surface (codex view_image limit)
• docs/assistant-plugins.md + README section, unit tests for new helpers

---

Summary by cubic

Plug the terminal into any coding assistant or agent by adding browser, run, and skill subcommands to drive a real browser from shell. Adds a background daemon, auto agent setup, persistent managed/cloud browsers between calls, and prints screenshot paths for easy viewing.

• New Features

  • browser exec: run Python with helpers; auto-creates browser-cli-<session>; prints “Screenshot saved to ”; caps screenshots at 1800px.
  • Control plane passthrough (browser status|connect|doctor|recover), including browser recover stop-owned-browser to cleanly stop managed browsers.
  • Persistent managed/cloud browsers across one-shot invocations with marker/record reattach; configure via BROWSER_USE_TERMINAL_PERSIST_BROWSERS and BU_EXTERNAL_BROWSER_STATE_DIR.
  • Assistant integration: skill subcommand installs embedded SKILL.md into ~/.claude, ~/.codex, ~/.config/opencode, ~/.agents; guides via AGENT_SETUP.md and docs/assistant-plugins.md. Adds run to execute a browser task to completion with streaming, optional --model, support for custom model_provider ids, and coverage for the new Google provider.

• Refactors

  • Exposed run_external_browser_command/run_external_browser_script and extracted shared preference/preflight helpers; added unit tests.
  • Marked read-only commands (help, doctor, domain, etc.) as passive to avoid unintended auto-connect during assistant bootstraps.
  • Dropped the special terminal agent when invoked by another agent to prevent nested delegation.

^{Written for commit 2afd0e0. Summary will update on new commits.}

[cubic-dev-ai]

No issues found across 7 files

_{Re-trigger cubic}

[cubic-dev-ai]

1 issue found across 5 files (changes from recent commits).

<sub>Tip: Review your code locally with the cubic CLI to iterate faster.

Fix all with cubic | Re-trigger cubic</sub>

[cubic-dev-ai]

1 issue found across 4 files (changes from recent commits).

<sub>Tip: Review your code locally with the cubic CLI to iterate faster.

Fix all with cubic | Re-trigger cubic</sub>