tauri-browser

A CLI + Tauri plugin for automating and inspecting Tauri apps. Ref-based element targeting with output designed for LLM consumption.

Install the Skill

Add the Claude Code skill to your project:

npx skills add thrashr888/tauri-browser

Or install globally:

npx skills add thrashr888/tauri-browser -g

Install the CLI

cargo install tauri-browser

Setup

Add the plugin to your Tauri app behind a feature flag:

# Cargo.toml
[dependencies]
tauri-plugin-debug-bridge = { version = "0.2", optional = true }

[features]
debug-bridge = ["tauri-plugin-debug-bridge"]

// src-tauri/src/lib.rs
#[cfg(feature = "debug-bridge")]
app.plugin(tauri_plugin_debug_bridge::init());

Add the permission to capabilities/default.json:

"debug-bridge:default"

Run your app with the feature enabled:

cargo tauri dev --features debug-bridge

Authentication

The plugin generates a random auth token on each startup, printed to stdout:

debug-bridge auth token: a1b2c3d4e5f6...

Pass it to the CLI:

export TAURI_BROWSER_TOKEN="a1b2c3d4e5f6..."
tauri-browser connect

# Or per-command:
tauri-browser --token "a1b2c3d4e5f6..." connect

The /health endpoint does not require auth.

Usage

tauri-browser connect                        # verify connection
tauri-browser snapshot -i                    # interactive elements with @refs
tauri-browser click "@e3"                    # click by ref
tauri-browser fill "@e2" "user@example.com"  # fill input by ref
tauri-browser run-js "document.title"        # execute JS
tauri-browser screenshot out.png             # capture screenshot
tauri-browser windows                        # list app windows
tauri-browser invoke get_data '{"id":1}'     # call Tauri commands
tauri-browser events emit "refresh" '{}'     # emit events
tauri-browser console                        # stream JS console output
tauri-browser logs --level warn              # stream Rust logs

Architecture

tauri-browser (CLI)  ◄──── HTTP/WS ────►  tauri-plugin-debug-bridge (in-app)
                         localhost:9229

The plugin starts a local HTTP+WS server inside your Tauri app. The CLI talks to it. No app code changes needed beyond plugin registration.

Troubleshooting

401 Unauthorized on all requests Set TAURI_BROWSER_TOKEN to the token printed at app startup. The token changes every time the app restarts.

Eval/invoke times out after 10-30s The debug-bridge:default permission must be in your capabilities/default.json. Without it, Tauri silently blocks the eval_callback command and results never return.

Console streaming shows nothing Make sure you're on plugin version 0.2.5+ which includes console_callback in the default permission set. Earlier versions only permitted eval_callback.

Port already in use Configure a different port in tauri.conf.json:

{
  "plugins": {
    "debug-bridge": {
      "port": 9230
    }
  }
}

Then connect with tauri-browser -p 9230 connect.

License

MIT

tauri-plugin-debug-bridge 0.3.0