📈 GH Trending Explorer 🎲 Surprise me

← all repos

amontlabs / lcu

git clone https://github.com/amontlabs/lcu.git v0.11.7 · today

Codex computer use, decoupled from the app, for usage inside any harness.

—
stars, 24h
—
stars, 7 days
+1.9k
stars, 30 days · #164
1.9k
★ total
109
forks · 2 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageJavaScript
LicenseMIT
Created2026-09-22 (28d ago)
Last pushtoday
Watchers4
OwnerOrganization

GitHub topics

Links

README excerpt
LCU 
 Codex computer use, decoupled from the Codex app. 
https://github.com/user-attachments/assets/bd9d0809-8a6c-4931-a51c-b98daf05cb5f
LCU exposes Codex's original computer-use runtime to your harness without requiring Codex authentication. The official ChatGPT desktop app must still be installed locally: it supplies the runtime and instructions, while LCU handles setup and harness integration.
## Quick start
Copy this into your agent:
 [code] 
In Claude Code on an Apple Silicon Mac, two commands do the same through its plugin manager; see Claude Code plugin:
 [code] 
## Features
- **Desktop apps:** read windows, click, type, and take screenshots.
- **Chrome, when enabled:** read and control tabs through the official extension, with site approval.
- **In your harness:** adapters are available for Pi, Codex CLI, and Claude Code, with experimental Oh My Pi and Hermes integrations. See setup and verification limits.
## Approve apps from Claude, natively
The first time an agent controls an app (Zed, Notes, Safari), the computer-use runtime asks you to allow it. The Claude app's Code tab used to fail that request with "Computer Use was not approved". `lcu setup --agent claude-code` now installs a small Claude Code mod, `lcu-approve`, that asks the question natively: as a question card in the Claude app, which flags the session as needing input, and as a **Computer use approval** pane in the terminal.
- **Allow this conversation** for the current chat only.
- **Always allow** to remember the app (offered only when the runtime allows it).
- **Deny** to refuse.
The `/computer-use-apps` command opens an **Approved apps** panel in the same place: one line per always-allowed app with Revoke (macOS asks for Touch ID or your password), apps that are no longer installed grouped below, this conversation's grants, and an Allow field.
Only you can answer: the model cannot see, press or fake the pane. High-risk apps show the runtime's own warning (reworded to say "computer use" and "the agent"), and the app hosting the agent is never approved. Needs the Claude app or Claude Code 2.1.287+. How it works, how to remove it.
In the Claude app, register LCU through Claude Code (`lcu setup --agent claude-code`), not through Settings > Connectors; see installation.
## Manage approved apps with Touch ID
"Always allow" is remembered. Review and change that list from the terminal (macOS), without opening the Codex app:
 [code] 
- Pass an app name, a bundle identifier or an `.app` path.
- Listing is free; `allow` and `revoke` need you at the machine, so an agent running them is stopped by the prompt.
- Running sessions pick the change up immediately.
- Browsers, password managers and other high-risk apps come with a warning; apps Computer Use refuses outright (Terminal, iTerm2) are declined.
Details.
## Keep Computer Use across turns (Claude Code)
In Claude Code, Computer Use normally ends with the turn that started it. A background subagent still working after that turn en