shirabe 0.1.0

Headless browser automation — CDP engine + HTTP debug API
Documentation
![Debug server overview](../../../res/debug_server_solarized_dark.png)

# Quick Start

![Debug server overview](../../../res/debug_server_solarized_dark.png)

## The CLI

```bash
# Zero-config: auto-discovers Chrome/Chromium/Edge, or fetches Chrome for Testing.
shirabe debug --port 3001

# Pin a backend, route the browser through a proxy.
SHIRABE_BACKEND=chromium shirabe debug --port 3001 --proxy http://localhost:7890
```

Then drive the running server over HTTP:

```bash
curl -X POST http://localhost:3001/navigate \
  -H "Content-Type: application/json" -d '{"url":"https://example.com"}'

curl -X POST http://localhost:3001/screenshot -d '{}'
```

## The library

```rust
use shirabe::{start_debug_server, DebugServerConfig};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let cfg = DebugServerConfig {
        base_url: "about:blank".to_string(),
        dev_port: 0,
        dist_dir: String::new(),
        package_name: String::new(),
        proxy: None,
    };
    start_debug_server(cfg, 3001).await
}
```

See [Backends & Resolution](./backends.md) for how an executable is found, and
[Bundling Native Libraries](./bundling.md) for shipping a self-contained
product.