Docs

First Run

Open Cocxy, connect shell integration, and run the first local agent session.

Install

brew tap salp2403/tap && brew install --cask cocxy

Visual Tour

Open the sidebar, browser, and Vault to confirm local state.

Concepts

Tabs, panes, sessions, agents, and Vault live on your Mac.

Configuration

.cocxy.toml controls themes, hooks, agents, and security per project.

Keyboard Shortcuts

Use the command palette to discover actions without memorizing shortcuts.

Agent Detection

cocxy setup-hooks installs local hooks and cocxy status verifies state.

Code Review

Review diffs, inline comments, and changes before returning feedback.

Markdown

Open documents, preview, and export without leaving the local workspace.

Quick Look

Preview content offline with sanitization.

Browser

Use the built-in browser for localhost, docs, and web apps.

Remote Workspaces

SSH, SFTP, proxy, and daemon paths start only from explicit action.

Web Terminal

Use remote sessions only when you start the connection.

Shell Integration

zsh, bash, and fish preserve your dotfiles.

Per-project Config

Repo-local settings stay separate from the global profile.

AppleScript

Automate windows and tabs through system permissions.

Plugin System

Plugins use TOML manifests and explicit permissions.

Splits

Place terminal, browser, and Markdown surfaces side by side.

Quick Terminal

Open a lightweight console without losing context.

Notifications

Local alerts are based on visible events.

Command Palette

Search actions, windows, and commands from one place.

Sessions

Resume work from local Vault history.

Local Backups

Preferences > Backups lets you Restore only the selected artifact.

Input Classifier

[input-classifier]
dangerous-command-warning = true
auto-route-natural-language = false
foundation-models-fallback = true
cocxy classify
dangerous-command
natural-language

Command Signatures

[security]
require-signed-templates = false
require-signed-macros = false
require-signed-plugins = false
warn-on-unsigned = true
trust-on-first-use = false
cocxy keys generate --author
cocxy sign template
cocxy verify template
verified
unsigned
invalid signature

Sandbox Controls

[security.sandbox]
plugins-strict = true
agents-isolated = true
mcp-isolated = true
audit-log-enabled = true
warn-on-grant = true
cocxy sandbox list-grants
cocxy sandbox revoke
Sandbox Inspector
Agent command tools run with workspace-scoped read/write access

Command Corrections

[command-corrections]
edit-distance-threshold = 2
foundation-models-enabled = true
agent-fallback = false
auto-show-on-failure = true
show-confidence-badge = true
cocxy correct
gti status
pyhton -m venv .
Tab
Esc

CLI Companion

cocxy --help lists commands for local automation.

Themes

Configure colors, font, and contrast from preferences.

agents.toml

Define custom agents, patterns, and resume rules.

Migration from v0.x

~/.config/cocxy/ keeps configuration; use brew update && brew upgrade --cask cocxy.

Troubleshooting

Run cocxy doctor and inspect local permissions.