# Browser Use Terminal Explain Like I'm 5 Wiki

> A plain-language map of a Rust terminal app that lets a person steer browser agents from the command line. The structure stays provider-neutral: model providers, browser backends, local files, and catalog-style prompt material are treated as swappable parts.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c)
- [GitHub repository](https://github.com/browser-use/terminal)

## Repository

- Repository: browser-use/terminal

- Generated: 2026-05-22T22:46:16.272Z
- Updated: 2026-05-22T22:46:30.480Z
- Runtime: Codex CLI
- Format: Explain Like I'm 5
- Pages: 6

## Pages

- [Explain It Simply](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/01-explain-it-simply.md): What this repo does in plain language, the simplest useful analogy, and the few ideas the reader should remember.
- [Install, Run, and Pick a Browser](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/02-install-run-and-pick-a-browser.md): How the repo turns shell commands into Rust binaries, where state lives, and why the browser choice can be local Chrome, headless Chromium, or Browser Use cloud.
- [The Terminal Workbench](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/03-the-terminal-workbench.md): The TUI is the steering wheel: it renders the current work, accepts keys and slash-style choices, starts agent runs, and keeps the screen usable while work is live.
- [The Agent Loop and Its Tools](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/04-the-agent-loop-and-its-tools.md): The agent loop is the careful helper: it asks a model provider for the next move, exposes browser and filesystem tools, records events, and stops only when a done, failure, or cancellation path is reached.
- [The Browser Driver](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/05-the-browser-driver.md): The browser layer is the remote-control box: Rust owns CDP connections and browser lifecycle, while Python helper code runs page scripts, collects artifacts, and reports browser events without forcing one model vendor.
- [Remember This Map](https://grok-wiki.com/public/wiki/browser-use-terminal-686510dbe50c/pages/06-remember-this-map.md): A closing recap: the TUI is the steering wheel, the agent loop is the helper, the browser driver is the remote-control box, and the store plus tests are how the repo remembers and proves what happened.

## Source Files

- `Cargo.toml`
- `crates/browser-use-browser/src/browser_script_helpers.py`
- `crates/browser-use-browser/src/lib.rs`
- `crates/browser-use-cli/src/main.rs`
- `crates/browser-use-core/src/lib.rs`
- `crates/browser-use-core/src/tools/command.rs`
- `crates/browser-use-core/src/tools/files.rs`
- `crates/browser-use-core/src/tools/mod.rs`
- `crates/browser-use-protocol/src/lib.rs`
- `crates/browser-use-providers/src/lib.rs`
- `crates/browser-use-python-worker/src/lib.rs`
- `crates/browser-use-store/migrations/0001_initial.sql`
- `crates/browser-use-store/src/lib.rs`
- `crates/browser-use-tui/src/composer.rs`
- `crates/browser-use-tui/src/main.rs`
- `crates/browser-use-tui/src/palette.rs`
- `crates/browser-use-tui/src/render.rs`
- `crates/browser-use-tui/src/runtime.rs`
- `crates/browser-use-tui/src/settings.rs`
- `crates/browser-use-tui/src/transcript.rs`
- `docs/terminal-ui-product-ux.md`
- `docs/terminal-ui-testing.md`
- `prompts/browser-agent-system.md`
- `prompts/browser-script-tool-description.md`
- `prompts/browser-tool-description.md`
- `prompts/interaction-skills/connection.md`
- `prompts/interaction-skills/profile-sync.md`
- `prompts/python-tool-description.md`
- `pyproject.toml`
- `python/llm_browser_worker/rust_cli.py`
- `python/llm_browser_worker/worker.py`
- `README.md`
- `scripts/install/install.sh`
- `scripts/tui-terminal-smoke.py`
- `scripts/verify-terminal-ui.sh`
- `tests/golden-events/running-browser-session/events.jsonl`
- `tests/golden-events/running-browser-session/session.json`