jev-desktop

# Jev Desktop for Codex

[](https://github.com/yikangy873-gif/jev-desktop/actions/workflows/test.yml)

[](LICENSE)

Jev Desktop adds a bounded decision loop to Codex Computer Use for browser tabs and native macOS apps.

- **Codex** understands the goal, prepares text, defines the allowed actions, and verifies the result.
- **TypeSafe Jev** selects an operation and its compatible target in one request.
- **Computer Use** observes the approved interface and performs the actual click, fill, scroll, or shortcut.

It reuses the existing Codex Computer Use runtime. It does not install a second browser controller, call private Computer Use APIs, require Browser Harness, or use OpenRouter to generate field text.

## Why this exists

Returning to the main agent after every UI click adds latency and loses short-term action context. Jev Desktop keeps one bounded session inside the existing Computer Use runtime, while Codex retains control of scope, permissions, prepared values, recovery, and final verification.

The plugin is intentionally not a general unrestricted desktop agent. Every executable control must be explicitly allowed by the calling Codex task.

## How it works

```mermaid
flowchart TD
    U[User goal] --> C[Codex plans and scopes the task]
    C --> F{Deterministic fast path?}
    F -->|Yes| D[Direct connector or CUA action]
    F -->|No| S[Create bounded Jev session]

    subgraph Local[Local machine]
        S --> O[CUA reads a full accessibility snapshot]
        O --> P[Parse indexed elements]
        P --> A[Apply action and safety allowlists]
        A --> R{Sensitive or consequential control?}
        R -->|Yes| H[Return control to Codex]
        R -->|No| Q[Build operation head and compatible target heads]
        Q --> BC[Authenticated loopback bridge]