lcu README

The project's README from github.com/amontlabs/lcu. As one markdown file: README.md.

LCU logo

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:

Install and configure LCU for this harness using the latest release.
Follow https://raw.githubusercontent.com/amontlabs/lcu/main/docs/INSTALLATION.md
Check my OS, architecture, and prerequisites, then guide me through any required permissions.

In Claude Code on an Apple Silicon Mac, two commands do the same through its plugin manager; see Claude Code plugin:

claude plugin marketplace add amontlabs/lcu
claude plugin install lcu@lcu

Features

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 shows the question as a native Computer use approval pane in the Claude app, and in the terminal.

The Computer use approval pane in Claude Code: Allow this conversation, a high-risk app with its warning, and the Approved apps panel

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:

lcu apps                 # what is always allowed today
lcu apps allow Zed       # Touch ID (or your password), then Zed is allowed
lcu apps revoke Zed      # take it back

The Approved apps panel opened with /computer-use-apps

Details.

Permissions

Your harness decides whether the agent may call LCU's tools (Claude's "don't ask again" on the first card, Codex's tool approval, and so on). LCU decides, per app, whether that agent may touch it, in every permission mode. lcu setup --approval auto is optional and meant for unattended machines (VMs, CI): it pre-allows LCU's two model tools in the harness, and leaves per-app approval in force. See approval mode.

Requirements

Install the official ChatGPT desktop app, Python 3.12+, and your harness first. LCU checks the installed app for compatibility and uses its original runtime. For Codex CLI, update before setup to get the required hook support.

Platform Requirements
Linux ARM64 or x86-64 Ubuntu 24.04-compatible glibc system, an active X11 desktop, and D-Bus
macOS on Apple Silicon The signed ChatGPT app, with Accessibility and screen-recording permissions approved during first use

Windows 11 x64 remains a candidate. Intel Macs, native Wayland, and musl Linux are unsupported. See verification and limits for tested behavior.

Install manually

Download the archive and matching .sha256 file from the latest release:

Platform Archive
macOS on Apple Silicon lcu-<version>-darwin-arm64.tar.gz
Linux ARM64 lcu-<version>-linux-arm64.tar.gz
Linux x86-64 lcu-<version>-linux-x64.tar.gz

Follow the installation guide to verify the checksum, extract the archive, and register LCU in your harness. Setup offers an agent chooser and desktop-readiness guidance. Chrome and computer-audio recording are opt-in.

For development, see building from source.

Enable Chrome

Ask your agent:

Enable Chrome control in my LCU setup using the installation guide:
https://raw.githubusercontent.com/amontlabs/lcu/main/docs/INSTALLATION.md#desktop-and-browser

Enable the official extension in your Chrome profile and restart your harness. Then ask it to use LCU to list Chrome tabs. Sites still require approval. Claude Code's Chrome support remains experimental because some interruptions do not trigger tab cleanup; see adapter limitations.

Enable computer-audio recording

Pass --audio when setting up a maintained harness, for example:

~/.local/share/lcu/current/bin/lcu setup --agent pi --audio

The installer does not add lcu to your PATH; run its installed path (/opt/lcu/current/bin/lcu on Linux). See the lcu command.

This enables the installed original runtime's optional computer-audio recording API and its original approval flow. LCU does not add audio-specific instructions, and a saved recording is not audio delivered to the model. See the audio opt-in verification record.

Pi commands

In interactive Pi, /lcu stop requests original Computer Use Stop for a selected app during the active LCU turn (macOS only). /lcu pick selects an original app or browser target and appends it to the editor draft while Pi is idle; review and submit the draft yourself. See adapter command behavior and limits.

Documentation

LCU is MIT licensed. Release archives contain LCU and third-party setup dependencies. The OpenAI app and its instructions come from your local installation and retain their own terms; see dependency provenance.

lcu (amontlabs/lcu)

Searching Database…

1.2K ·GitHub
Lcu
Что это?LCU извлекает встроенный рантайм computer-use из Codex в десктоп-приложении ChatGPT и открывает его любому ИИ-харнессу для кодинга (Claude Code, Codex CLI, Pi), чтобы агент мог кликать, печатать, читать окна и делать снимки экрана на вашей машине без аутентификации в Codex.
LCU заменяет десктоп-приложение ChatGPT или оно ему всё ещё нужно?Оно всё ещё нужно. Официальное десктоп-приложение ChatGPT должно оставаться установленным локально, потому что именно оно предоставляет рантайм computer-use и инструкции; LCU лишь занимается настройкой и подключает этот рантайм к вашему харнессу.
Как это установить и настроить?Скачайте подходящий архив и его файл .sha256 из последнего релиза на GitHub для своей платформы (macOS Apple Silicon, Linux ARM64 или Linux x86-64), проверьте контрольную сумму, распакуйте и зарегистрируйте LCU в своём харнессе; в Claude Code его вместо этого можно установить через менеджер плагинов двумя командами.
Что должно быть установлено перед запуском?Нужны официальное десктоп-приложение ChatGPT, Python 3.12+ и уже настроенный поддерживаемый харнесс (Pi, Codex CLI или Claude Code); для Codex CLI его сначала нужно обновить, чтобы получить необходимую поддержку хуков.
Какие платформы реально работают сейчас?Только Linux ARM64/x86-64 с активным X11-десктопом и D-Bus, а также macOS на Apple Silicon с подписанным приложением ChatGPT. Windows 11 значится лишь «кандидатом», а Intel Mac, нативный Wayland и musl Linux не поддерживаются.
Кто в итоге разрешает агенту трогать приложение на моей машине?Только вы. Подтверждения происходят в нативной панели, которую модель не может увидеть, нажать или подделать, а позже доступ можно отозвать для каждого приложения отдельно — на macOS при этом запрашивается Touch ID или ваш пароль.
Может ли агент управлять ещё и вкладками моего Chrome?Да, если вы включите официальное расширение Chrome в своём профиле. Тогда LCU сможет читать вкладки и управлять ими, но каждый сайт по-прежнему требует отдельного подтверждения, а поддержка Chrome в Claude Code пока экспериментальная.
Может ли агент записывать звук с моего компьютера?Только если передать --audio при настройке. Это просто включает собственный API записи звука и поток подтверждений нижележащего рантайма ChatGPT; сам LCU не добавляет никаких инструкций, связанных со звуком.
Что конкретно можно делать с LCU внутри Pi?Pi получает две слэш-команды: /lcu stop запрашивает остановку Computer Use для выбранного приложения (только macOS), а /lcu pick выбирает приложение или цель в браузере и добавляет её в ваш черновик на проверку и отправку.
Зачем создавать LCU, если можно напрямую использовать computer use от Codex?Рантайм computer-use от Codex обычно привязан к приложению Codex и его собственному входу; LCU отвязывает этот рантайм, чтобы другие харнессы вроде Claude Code или Pi могли использовать его без учётной записи Codex.
What are similar projects?pstack-claude, newsjack, hive, openrig, midscene, agent-desktop, awesome-chatgpt-zh, jev-browser-use
Which topics is it in?permission, pi-agent, desktop-automation, x11, codex-cli, computer-use, chrome-extension, harness, accessibility, browser-automation, chatgpt, desktop
Creator
amontlabs
Size
13.3 MB
Stars
1.2K
Updated
CommitOct 14Releasev0.11.4Oct 14
Age
26d
Commits · 90 Days