## Open windows and Electron apps

The CLI drives a window you have open through the extension: `--attach` takes over the first window and
`--target-match TEXT` picks one by title or URL, and neither opens a DevTools port. Without `--start` the run begins
on whatever the window shows, and the window stays open afterwards. Popups the window opens join the run.

An Electron app, or a browser you start with `--remote-debugging-port`, has no extension, so drive it from an SDK
with `cdp_url=` or `cdp_port=`, `attach=True` and `target_match=` (see [Embed it](/docs/python#embed-it)). The CLI
refuses `--cdp-url` and `--cdp-port`. A DevTools port gives any program on the machine full control of the app and
its sessions: close the app, or restart it without the flag, when you are done.

## Desktop apps

`--desktop APP` starts a native Wayland app on a Hyprland desktop and runs the task in its window, through
[deskpilot](https://github.com/cjber/deskpilot). `APP` is the command line that starts the app, split into words as a
POSIX shell splits them, with no shell running it. The run starts it with deskpilot's `launch` as a deskpilot agent of
its own, so the window opens on that agent's hidden workspace, and the app closes when the run ends. A window that is
already open is not driven: deskpilot sends input in the background only to an app its agent launched. It needs a
deskpilot with `launch` ([cjber/deskpilot#86](https://github.com/cjber/deskpilot/pull/86)); with an older one the run
ends `unavailable`. Jev picks each action from the window's accessibility tree, and deskpilot clicks and types in the
background, so the pointer and keyboard focus stay where you left them:

```sh
fastbrowse --desktop gnome-text-editor "Write 'hello' in a new document."
```

An app that runs as one instance, such as one you already have open, may hand its new window to that copy, so
`launch` sees no window of its own and the run ends with deskpilot's error. Pass the app's flag for a separate
instance when it has one.

A password field is never read, and `--secret NAME=ENV_VAR@desktop://<class>` types a secret only into the window of
that app class. `--authorize` and the step and spend ceilings work as for a browser. An open combo box's list and a
popup menu's entries are controls like any other, and the run clicks the item it wants. Choosing a combo box's option
by name uses the keyboard: a list the click opened is closed again and the arrow keys move the choice. The run stays in the one
window: a dialog the app opens as a window of its own is out of its reach. Recipes, `--start` and every browser
option are refused. Set `FASTBROWSE_DESKPILOT` to run a `deskpilot` that is not on `PATH`.