# X11/EWMH Computer Use Linux Feature

This optional Linux Feature stages the standalone `codex-computer-use-x11` MCP plugin into Codex Desktop Linux. It stays disabled by default and is enabled only when listed in `linux-features/features.json`.

## Enable

Enable through the git-ignored upstream file `linux-features/features.json`:

```json
{ "enabled": ["x11-ewmh-computer-use"] }
```

## Baseline

Supported baseline: Linux Mint Cinnamon on X11 / `x11-ewmh`.

## Tools exposed

The staged plugin exposes the standalone namespaced tool surface:

- `x11_doctor`
- `x11_list_windows`
- `x11_focused_window`
- `x11_focus_window`
- `x11_accessibility_tree`
- `x11_type_text`
- `x11_press_key`
- `x11_click`
- `x11_scroll`
- `x11_drag`
- `x11_get_app_state`
- `x11_target_window`
- `x11_target_context`
- `x11_release_window`

## Staging modes

Pinned local artifact mode:

```bash
CODEX_X11_COMPUTER_USE_RELEASE_TARBALL=/path/to/codex-computer-use-x11-v<VERSION>-x86_64-unknown-linux-gnu.tar.gz
CODEX_X11_COMPUTER_USE_RELEASE_SHA256=<expected-sha256>
```

Default pinned release mode downloads and verifies v0.1.3 for x86_64 Linux only. Unsupported architectures fail fast unless you provide an explicit source, binary, tarball, or download override:

```bash
CODEX_X11_COMPUTER_USE_DOWNLOAD_URL=https://github.com/AlekseiSeleznev/codex-computer-use-x11/releases/download/v0.1.3/codex-computer-use-x11-v0.1.3-x86_64-unknown-linux-gnu.tar.gz
CODEX_X11_COMPUTER_USE_RELEASE_SHA256=067244a16f9e812eb369af42149658c8cf138b13057445bb9d10318f29b0c26b
```

Those values are built into `stage.sh`; set the variables only to override the pinned artifact.

Local source mode:

```bash
CODEX_X11_COMPUTER_USE_SOURCE=/path/to/codex-computer-use-x11
```

Direct binary test mode:

```bash
CODEX_X11_COMPUTER_USE_BINARY=/path/to/codex-computer-use-x11
```

## Upstream alignment

This feature wires the separate `codex-computer-use-x11` plugin as an opt-in Linux Feature. It does not move X11/EWMH behavior into the core Computer Use backend and does not replace the bundled `computer-use` plugin.

`agent-sh/computer-use-linux` selectable backend/flavor integration is a separate future investigation. If that route proves a better fit, handle it in a separate change or pull request; no backend/flavor experiment may require enabling this feature by default or modifying core Computer Use behavior in this feature.

## Non-goals

- no core Computer Use replacement;
- no Wayland/RemoteDesktop baseline;
- no default enablement;
- no submodule;
- no global doctor changes;
- no writes to user home from `stage.sh`.