A macOS terminal application with Agent Mode capabilities for local tool execution, file operations, command running, and computer use control.
Cocxy Terminal is a local Swift-based agent tool executor with 19 tools spanning file I/O, terminal control, and computer automation. While tool names follow verb_noun conventions (read_file, write_file, run_command), descriptions are inconsistent in depth and actionability. Most tools lack parameter validation guidance, output schemas are undocumented, and error handling is minimal. The server appears to be STDIO-only (no HTTP/SSE transport detected), which is a hard architectural limitation. Tool definitions are visible in source but lack the rigor expected for production agent use.
Apply a structured diff after user approval.
Request user input or approval for an action.
Click the mouse at the current or specified position.
Move the mouse cursor to a specified screen position.
Capture a screenshot of the current screen.
Type text at the current cursor position.
Get Git diff output for repository changes.
Output schemas undocumented. No tool returns a documented response structure. LLMs cannot plan downstream calls or extract required fields (e.g., what does git_status return? What fields does search_codebase include?). This violates pattern:tool and pattern:response-shaper.
Computer automation tools (computer_move_mouse, computer_click, computer_type_text, computer_screenshot) lack error recovery guidance. No description explains what happens on failure, whether retries are safe, or how to handle screen state changes. Violates pattern:recovery-guide.
Parameter validation constraints missing. search_files 'limit' and grep 'limit' lack min/max bounds. read_terminal_output 'blockLimit' is undocumented. LLMs will pass arbitrary values (0, -1, 999999) without guidance. Violates pattern:constrained-input.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Get the current Git repository status.
Search file contents with a local regex engine.
List a directory while respecting workspace boundaries.
List source-qualified local built-in, user, and project skills available to the agent.
Read a repository file after path validation.
Read LSP (Language Server Protocol) diagnostics for the workspace.
Read captured terminal output from the active terminal or focused split.
Execute a shell command in the workspace with approval.
Search the local codebase with lexical fallback when semantic indexing is unavailable.
Find files by glob or fuzzy path query.
Load one local skill and return its reusable instructions. Pass the source from list_skills; an id alone is accepted only when unambiguous.
Write a repository file through mandatory diff preview.
Destructive operations (write_file, apply_diff, run_command) lack confirmation or dry-run patterns. No description warns that these are irreversible or require approval. Violates pattern:confirmation-request.
STDIO-only transport detected. No HTTP or SSE support visible. STDIO servers are not remotely accessible and cannot integrate with hosted MCP clients. This is a hard architectural limitation that caps protocol readiness at 50.