All Features

Multi-Layer AI Agent Detection

Cocxy's detection engine recognizes AI coding agents in real time without intercepting or modifying agent traffic. Four independent layers (hooks, OSC sequences, pattern matching, and timing heuristics) cross-validate each other so detection stays accurate even when one signal is missing.

Six agents supported out of the box: Claude Code, Codex CLI, Gemini CLI, Aider, Kiro, and OpenCode. Custom agents can be added via ~/.config/cocxy/agents.toml.

Run cocxy setup-hooks once to auto-configure the hook protocol in every agent installed on your machine. Claude Code, Codex, Kiro, and Gemini get hook support; Aider and OpenCode fall back to pattern matching.

Dashboard, timeline, and smart routing: live view of every session's state, a chronological event log with six filters, and a one-keystroke jump to the tab that needs attention.

Agent Code Review Panel

A native panel that shows every file an agent touched during a session. Press Cmd+Option+R to open.

Diff viewer — File tree with status icons (added, modified, deleted, renamed), unified diff with line numbers, and per-author chips when multiple agents edited the same session.

Inline comments — Click any line in the gutter to attach a comment. Submit all pending comments via the PTY; the agent formats the feedback as context and re-runs.

Accept or reject hunks — Granular control via git apply --cached to accept and git apply --reverse to reject. Queued serially so hunks never race.

Keyboard-first — j, k, n, p, c, a, r, d shortcuts for navigation and actions. Cross-tab-safe: feedback always reaches the agent in the originating tab.

Native Markdown Workspace

A first-class Markdown panel that renders in a split pane next to your terminal. Written from scratch in pure Swift — no third-party parser, no network calls, no WebView dependency for the core renderer.

Editable source view — Undo / redo, AppKit Find bar, debounced auto-save, file watcher deduplication, and AppKit autosubstitutions disabled so Markdown syntax is never silently rewritten. Cmd+B, Cmd+I, Cmd+K for formatting.

Live preview — Mermaid diagrams, KaTeX math, GitHub Flavored Markdown, fifteen callout types, footnotes with hover previews, highlight / superscript / subscript, 200+ emoji shortcodes, reference-style links, setext headings, sortable tables, inline [TOC], and syntax highlighting for 190+ languages via bundled Highlight.js.

Interactive preview — Clickable task list checkboxes that write back to the source, double-click to jump from preview to source, image lightbox, clipboard image paste, drag-and-drop image insertion, and one-click TSV copy for tables.

Workspace features — Outline sidebar, multi-file full-text search, file explorer with rename / move-to-trash / reveal-in-Finder, and live git blame and diff views.

Export — Print to PDF, standalone HTML with inlined base64 images, slide deck split on horizontal rules, and copy as Markdown / HTML / RTF / plain text.

QuickLook Preview Extension

A system-integrated extension that renders .md files directly in macOS Finder's QuickLook. Select a Markdown file in Finder, press Space, and see the fully rendered preview with Mermaid diagrams, KaTeX math, callouts, and syntax highlighting — all offline, all local.

Built as a sandboxed .appex plugin following Apple's app extension conventions. Registered automatically when you install Cocxy.

GPU Terminal Engine (CocxyCore)

A custom terminal engine built in Zig with a stable C ABI, running on Metal for GPU-accelerated rendering. Cross-platform ready for macOS and Linux.

Metal-accelerated rendering — 120 fps smooth scrolling with a GPU-backed glyph atlas. Per-surface locking serializes the PTY feed against the frame build to eliminate render race conditions. CVDisplayLink re-anchoring when the window moves between displays with different backing scales.

Font ligatures — OpenType ligatures via CoreText shaping with a configurable toggle and per-glyph caching.

Inline image protocols — Sixel and graphics-protocol image display with configurable memory limits, transfer toggles, and atlas management.

GPU-accelerated regex search — Native scrollback search runs on the GPU with a Swift fallback for compatibility.

Diagnostics — Inspect cursor visibility, alt-screen state, application cursor mode, semantic block count, and bridge mode from the CLI with cocxy core-modes.

Remote Workspaces

SSH multiplexing with persistent sessions, proxy management, agent relay, and a remote daemon — all from the client, zero installation required on the server.

Persistent tmux-backed sessions survive SSH disconnects. Reconnect and re-attach with state intact.

SSH multiplexing via OpenSSH ControlMaster shares a single authenticated TCP connection across every tab talking to the same host.

SOCKS5 and HTTP CONNECT proxy with system-wide macOS integration, PAC generation, per-host exclusion lists, and health monitoring with auto-failover.

Agent relay — Multi-channel reverse tunnels with HMAC-SHA256 authentication, per-channel ACLs, JSON audit logs, token rotation, and Keychain persistence.

Remote daemon — POSIX shell daemon with three-level session fallback (tmux / screen / native PTY), persistent port forwards, file sync watching, and 24-hour auto-cleanup.

SFTP browser and auto-reconnect with exponential backoff for dropped connections.

Built-in Browser

Preview dev servers, read docs, and inspect web output without switching apps. Isolated profiles for cookies and storage, integrated DevTools with Console / Network / DOM inspection, nested bookmarks, and downloads with progress. Dock it as an overlay panel or embed it side-by-side with your terminal in a split.

Web Terminal Embed

Expose any local terminal over HTTP with a zero-dependency frontend. Tunable frame rate, on-demand full-frame refresh, per-terminal attach and detach, and connection-level events exposed to plugins for custom integrations. Useful for peer programming, remote assistance, or embedding a live terminal into an internal dashboard.

Plugin System

Event-driven plugin architecture. Drop a manifest and shell scripts into ~/.config/cocxy/plugins/ and respond to eight terminal events: session start / end, agent detected, agent state changed, command complete, tab created / closed, and directory changed.

Scripts run in a sandboxed environment with a clean PATH, a timeout enforcement, and no privilege escalation. Manage with cocxy plugin-list, cocxy plugin-enable, and cocxy plugin-disable.

Per-Project Configuration

Drop a .cocxy.toml file in any project root to override global settings per directory. Cocxy detects it when you cd in and applies the overrides with hot-reload. Override fonts, padding, opacity, agent detection rules, and keyboard shortcuts on a per-project basis. Useful for projects with specific agent workflows or visual requirements.

AppleScript Automation

Full AppleScript vocabulary so you can script workflows and integrate Cocxy with Shortcuts, Automator, and Raycast. Create tabs, run commands, split panes, and read agent state from any automation framework that speaks OSA.

Shell Integration

Native shell integration for zsh, bash, and fish. Installed automatically, no setup required. Designed to coexist with Prezto, Oh My Zsh, YADR, starship, and custom prompts without disturbing them.

OSC 7 provides URI-encoded working-directory reporting; OSC 133 provides semantic prompts for command boundaries, duration, and exit codes. All environment variable injection restores your original ZDOTDIR, HOME, and XDG_CONFIG_HOME before loading your framework.

Zero Telemetry

Cocxy sends zero data to any external server. No analytics, no crash reporting, no usage tracking, no ping-home. Your terminal activity never leaves your machine.

This is a design constraint enforced by the code. The app requests no network entitlement beyond what Sparkle needs to check the update feed at cocxy.dev. You can verify with Little Snitch, LuLu, or any network monitor.

93-Command CLI Companion

The cocxy CLI exposes every major capability through a local Unix Domain Socket with per-UID authentication. Ninety-three commands covering tabs, splits, windows, sessions, agents, hooks, code review, Markdown, browser, remote, proxy, plugins, themes, timeline, diagnostics, and more.

Everything visible in the UI is scriptable from the shell. Integrate Cocxy into CI scripts, IDE extensions, or any workflow that benefits from terminal automation.

Ready to try it?

Free, open source, MIT licensed. macOS 14.0+ on Apple Silicon or Intel.