amontlabs/lcu

What is it?

Key features

• 01Reads windows, clicks, types and takes screenshots in desktop apps.
• 02Controls Chrome tabs through the official extension, with per-site approval.
• 03Provides adapters for Pi, Codex CLI and Claude Code.
• 04Lets users approve or revoke apps, with Touch ID on macOS.
• 05Requires no Python and runs on the Node bundled with the ChatGPT app.

Use cases

• Letting a coding agent test or operate a desktop app's GUI on a Mac or Linux workstation.
• Automating browser tabs in Chrome from an agent without a separate Codex login.
• Running computer-use agents on unattended VMs or CI machines with pre-allowed tools.

Quick start

1. 1

   Install the official ChatGPT desktop app and your harness first

2. 2

   Ask your agent to install LCU using the installation guide (copy the prompt from the README)

3. 3

   In Claude Code on Apple Silicon Mac, add the LCU plugin marketplace

   claude plugin marketplace add amontlabs/lcu
4. 4

   Install the LCU plugin in Claude Code

   claude plugin install lcu@lcu

Things to know

• !Requires the official ChatGPT desktop app to be installed locally.
• !Supports only macOS on Apple Silicon and Linux (ARM64 or x86-64 with X11); Intel Macs, native Wayland and Windows are unsupported or still a candidate.
• !Some features such as Chrome control and Claude Code native approvals are experimental or need extra setup.

Topics

FAQ

What is lcu?

Exposes Codex's computer-use runtime to any agent harness on macOS and Linux, without Codex authentication. LCU lets agent harnesses such as Pi, Codex CLI and Claude Code control desktop apps and Chrome through the original computer-use runtime from the ChatGPT desktop app. The ChatGPT app must be installed locally, since it supplies the runtime and instructions; LCU handles setup, per-app permissions and harness integration.

Is lcu free to use? What license does it have?

lcu is open source under the MIT license. Check the license terms before using it in commercial products.

Is lcu still maintained?

Actively maintained. The last commit to lcu was on Oct 19, 2026.

What can I use lcu for?

Letting a coding agent test or operate a desktop app's GUI on a Mac or Linux workstation. Automating browser tabs in Chrome from an agent without a separate Codex login. Running computer-use agents on unattended VMs or CI machines with pre-allowed tools.

How do I install lcu?

Install the official ChatGPT desktop app and your harness first Ask your agent to install LCU using the installation guide (copy the prompt from the README) In Claude Code on Apple Silicon Mac, add the LCU plugin marketplace: claude plugin marketplace add amontlabs/lcu Install the LCU plugin in Claude Code: claude plugin install lcu@lcu

Where can I get lcu?

The source code and installation instructions are on GitHub: https://github.com/amontlabs/lcu