{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "amontlabs-lcu--control-desktop-apps-from-codex-cli",
 "repo": "amontlabs/lcu",
 "repo_url": "https://github.com/amontlabs/lcu",
 "repo_slug": "amontlabs-lcu",
 "title": "Give Codex CLI control of desktop apps on macOS or Linux",
 "page_title": "How to give Codex CLI control of desktop apps on macOS or Linux with Lcu",
 "summary": "Register LCU with Codex CLI so the agent can see windows, click, type, and capture screenshots.",
 "who": "A developer running Codex CLI on a Mac or Linux desktop who needs the agent to test or operate a GUI app that has no API.",
 "problem": "Codex CLI cannot interact with desktop windows by itself, so GUI-only steps need manual work.",
 "outcome": "Codex CLI can read windows and take screenshots in a desktop app, and each app asks for approval before the agent touches it.",
 "steps": [
  "Update Codex CLI before setup, as the README requires for hook support.",
  "Download the archive for your platform and its matching `.sha256` file from the latest release, then verify the checksum and extract it.",
  "Run `~/.local/share/lcu/current/bin/lcu setup --agent codex` from the installed path, since the installer does not add `lcu` to your PATH. (inferred, check the README)",
  "Follow the setup prompts for desktop-readiness and permission guidance.",
  "Ask Codex CLI to list the windows of a named app and take a screenshot to confirm the connection. (inferred, check the README)"
 ],
 "agent_prompt": "Using the amontlabs/lcu repo, set up LCU for Codex CLI on this machine by following docs/INSTALLATION.md. Ask me to approve the desktop app named <app name>, then have the agent list its windows and take one screenshot. Report the setup result and confirm the screenshot was taken.",
 "agents": [
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "45 minutes",
 "basis": "readme",
 "caveat": "The README asks for a Codex CLI update before setup, and Linux support requires an active X11 desktop because native Wayland is unsupported.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "javascript",
 "requirements": [
  "The official ChatGPT desktop app installed locally",
  "Your agent harness installed (Claude Code, Codex CLI, Pi, or another supported adapter)",
  "macOS on Apple Silicon, or Linux ARM64 or x86-64 with an active X11 desktop and D-Bus",
  "Accessibility and screen-recording permissions on macOS, approved during first use"
 ],
 "risk": "dual-use",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The agent can see and type into any app you approve, including apps that show saved credentials or private messages."
  }
 ],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/amontlabs-lcu/control-desktop-apps-from-codex-cli/",
 "md": "https://dedupedai.com/use-cases/amontlabs-lcu/control-desktop-apps-from-codex-cli/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/amontlabs-lcu--control-desktop-apps-from-codex-cli.json",
 "api_version": "v1"
}