Skip to main content
Glama

CCUH

A macOS companion for app recognition and failed in-app actions in Codex Computer Use.

English | 한국어

WARNING

Under active development.

The Problem

Computer Use can connect to the wrong app or window, fail to enter text, or return from an action without the intended result. CCUH focuses on identifying these failures and helping the agent recover with evidence rather than repeating the same attempt silently. Existing app access restrictions and the user's input target must remain effective.

Related MCP server: agent-prompt-capture

Supported Environment

CCUH is currently being developed for Codex App and Codex CLI on macOS only. Computer Use must be available in the Codex client, and Node.js 24 or later is required.

The read-only macOS environment collector also requires Xcode or Command Line Tools for its local build. CCUH does not install these tools or request OS permissions automatically.

Windows support may be explored in the future if circumstances allow; there is no confirmed plan yet.

Environment Awareness

Before a Computer Use JS call, CCUH observes display geometry and on-screen window placement. Window titles, page content and input events are excluded. Unknown Spaces, exact fullscreen state and browser-tab-to-window mappings remain explicit rather than being inferred from one app window.

Execution Modes

Background is the default. Select a mode for the current chat with $ccuh-background or $ccuh-visible. In Codex App, type / and choose CCUH Background or CCUH Visible. Codex CLI also supports /skills.

Both modes share the same target checks and failure handling. Background applies automatically during Computer Use when no explicit mode has been selected.

Mode

Behavior

Background

Disallows deliberate window raising and workspace switching. Checks that the app is already running before acquisition and stops on closed or uncertain state.

Visible

Allows an explicitly selected task window to be brought into view through an exposed official action. Normal app approvals still apply.

These modes guide CCUH within official Computer Use; they do not change its internal engine.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides a local MCP interface to query captured, PII-scrubbed prompt telemetry from coding agents and browser chats, enabling time summaries, prompt search, and activity analysis without data leaving the machine.
      9
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides MCP tools to search and explore a locally stored screen history, query app/window activity, and manage recording controls such as pause and deletion.
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP clients such as Claude Code, Codex, and Cursor to debug failing traces, sessions, and exceptions, inspect route decisions, prompts, datasets, and metrics, and control token overhead via compact output, file dumps, and selective tool loading. It supports local stdio or HTTP deployment with optional read-only mode for safer observability workflows.
      -