CCUH
Provides macOS environment awareness and app/window recognition for Codex Computer Use, helping detect wrong app or window targets, failed text entry, and failed in-app actions so the agent can recover using evidence.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
CCUH
A macOS companion for app recognition and failed in-app actions in Codex Computer Use.
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query your team's AI coding history and act on HypAware recommendations from any MCP client.
MCP observability: analyse MCP server usage, investigate sessions, and instrument MCP servers.
MCP observability. Query live traffic, errors, duration, and alerts from your AI agent.
Analytics and debugging for your MCP server — explore usage and sessions, then root-cause errors.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceReads local Codex rollout logs to expose context-window usage snapshots, remaining-token estimates, and log-event freshness through a read-only MCP tool.MIT
- AlicenseAqualityBmaintenanceProvides 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.9MIT
- AlicenseNot gradedqualityBmaintenanceProvides 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
- FlicenseNot gradedqualityAmaintenanceEnables 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.-