Frequently asked questions

Cocxy Terminal is a native macOS terminal emulator built for developers working with AI coding agents. It detects agent state in real time, includes an inline code review panel, a full Markdown workspace with a QuickLook extension, GPU-accelerated rendering via Metal, persistent remote SSH sessions, and zero telemetry. It is free and open source under the MIT license.

Yes. Cocxy is completely free under the MIT license. There is no paid tier, no sign-up, no account, no subscription. Every line of code is public at github.com/salp2403/cocxy-terminal.

Six agents are detected out of the box: Claude Code, Codex CLI, Gemini CLI, Aider, Kiro, and OpenCode. Detection uses four layers: hook events (Claude Code, Codex, Kiro, Gemini), OSC escape sequences, output pattern matching, and timing heuristics. You can add custom agents in ~/.config/cocxy/agents.toml.

No. Cocxy sends zero data to any external server. No analytics, no crash reporting, no tracking of any kind. The app has no network entitlement beyond what Sparkle needs to check the update feed at cocxy.dev/appcast.xml. You can verify with Little Snitch, LuLu, or any network monitor.

macOS 14.0 (Sonoma) or later. Universal binary supporting both Apple Silicon (M1, M2, M3, M4) and Intel Macs. About 60 MB of disk space for the installed app. An internet connection is only required for downloading updates.

The recommended way is Homebrew: brew tap salp2403/tap && brew install --cask cocxy. Alternatively, download the signed and notarized DMG from the Releases page and drag the app into /Applications. The CLI companion is installed automatically.

Cocxy checks for updates automatically via Sparkle with EdDSA signature verification. If you installed via Homebrew, run brew update && brew upgrade --cask cocxy periodically. You can also download new DMGs manually from the Releases page.

A native panel that shows every file an AI coding agent changed during a session. Browse the diff, comment inline on any line, accept or reject individual hunks with git apply, and submit all pending comments back to the agent as formatted feedback through the PTY. Open it with Cmd+Option+R or cocxy review. It auto-opens when the agent session ends.

Yes. Cocxy is a full-featured terminal emulator with Metal-accelerated rendering, font ligatures, inline image protocols, multi-tab and split panes, scrollback search, shell integration for zsh / bash / fish, SSH multiplexing, and AppleScript automation. It works as a drop-in replacement for any other terminal on macOS.

Yes. Cocxy's shell integration is designed to coexist safely with Prezto, Oh My Zsh, YADR, starship, and any custom prompt. It restores your original ZDOTDIR, HOME, and XDG_CONFIG_HOME before loading your framework, so nothing about your shell configuration changes. You do not need to add anything to your dotfiles.

Yes, with first-class remote support: SSH multiplexing via OpenSSH ControlMaster, persistent tmux-backed sessions that survive disconnects, SOCKS5 and HTTP CONNECT system proxy, multi-channel agent relay with HMAC-SHA256 auth, a POSIX remote daemon, and SFTP file browsing. All from the client — no server installation required.

A first-class native Markdown panel that renders in a split pane next to your terminal. Edit Markdown with undo / redo, Find bar, and auto-save. Preview with Mermaid diagrams, KaTeX math, fifteen callout types, footnotes, and syntax highlighting for 190+ languages. Outline sidebar, multi-file full-text search, git blame and diff, slide export, interactive task list checkboxes, and a QuickLook extension for Finder previews — all offline, no network.

Yes. Cocxy ships with Catppuccin (Mocha and Latte), One Dark, and Solarized (Dark and Light). Drop a .toml theme into ~/.config/cocxy/themes/ and it appears immediately in the theme picker. You can configure a dark / light theme pair that auto-switches with the macOS appearance setting.

All configuration lives in ~/.config/cocxy/. The main file is config.toml for fonts, theme, terminal behavior, and keybindings. agents.toml holds agent detection patterns. You can also drop a .cocxy.toml in any project root to override settings per directory with automatic hot-reload when you cd in.

Yes. The cocxy CLI has ninety-three commands covering tabs, splits, windows, sessions, agents, hooks, code review, Markdown, browser, remote connections, proxy, plugins, themes, timeline, and terminal diagnostics. It communicates with the app through a local Unix Domain Socket authenticated by UID. Run cocxy help for the full reference.

Yes. Plugins respond to eight terminal events (session start / end, agent detected, state changed, command complete, tab created / closed, directory changed). Drop a manifest and shell scripts into ~/.config/cocxy/plugins/ and they run in a sandboxed environment with timeout enforcement. Manage with cocxy plugin-list, cocxy plugin-enable, and cocxy plugin-disable.

Yes, fully. Every line of code is public at github.com/salp2403/cocxy-terminal under the MIT license. Fork it, audit it, contribute. The CocxyCore terminal engine is a separate repository written in Zig with a stable C ABI, also open source.

Open an issue on GitHub Issues. Use the Bug Report template for bugs (Cocxy version, macOS version, chip, steps to reproduce) or the Feature Request template for enhancements. For security vulnerabilities, email [email protected] privately — do not open a public issue.

If you installed via Homebrew: brew uninstall --cask cocxy. Otherwise, drag the app to Trash. To remove your configuration and sessions too, delete ~/.config/cocxy/ and ~/Library/Application Support/dev.cocxy.terminal/. Note: deleting ~/.config/cocxy/ also removes SSH profiles, bookmarks, and browser history stored there.