Catalyst Code
Install

Get catcode on your machine.

One command installs the TUI and the Rust core to your PATH. Each platform also ships a standalone executable with the core embedded — run it from any directory with no install.

Linux

linux — bash
$curl -fsSL https://raw.githubusercontent.com/catalystctl/catcode/master/install.sh | bash
→ pulls the prebuilt binary from GitHub Releases
installed — catcode on PATH✓
With the web frontend
curl -fsSL https://raw.githubusercontent.com/catalystctl/catcode/master/install.sh | bash -s -- --with-web
Artifacts
catcode-<ver>-x86_64.AppImagecatcode-<ver>-linux-x86_64 (standalone)

Prebuilt binary pulled from GitHub Releases — no clone, no compiler. The hard sandbox (firejail / --no-network) is Linux-only.

macOS

macos — bash
$curl -fsSL https://raw.githubusercontent.com/catalystctl/catcode/master/install.sh | bash
→ pulls the prebuilt binary from GitHub Releases
installed — catcode on PATH✓
With the web frontend
curl -fsSL https://raw.githubusercontent.com/catalystctl/catcode/master/install.sh | bash -s -- --with-web
Artifacts
catcode-<ver>-macos-arm64.dmgcatcode-<ver>-macos-x86_64.dmg

Apple Silicon + Intel. DMG mounts and runs the “Install catcode.command”. Standalone .exe-style binary with core embedded also available.

Windows

windows — bash
$irm https://raw.githubusercontent.com/catalystctl/catcode/master/install.ps1 | iex
→ pulls the prebuilt binary from GitHub Releases
installed — catcode on PATH✓
With the web frontend
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/catalystctl/catcode/master/install.ps1))) -WithWeb
Artifacts
catcode-<ver>-windows.msi (per-user)catcode-<ver>-windows-x86_64.exe (standalone)

MSI adds catcode to PATH with no admin (clean Add/Remove Programs entry). Standalone embeds the core. bash tool needs Git Bash or WSL.

Build from source

Requires Rust (stable) and Go 1.24+. Clone, build the core and TUI, run.

bash — build
$git clone https://github.com/catalystctl/catcode.git catcode
$cd catcode
$./build.sh
→ builds core (cargo) + tui (go) + web (next)
$./tui/catcode

First run

Launch catcode from the directory you want to work in — that's your workspace. Then:

/loginLog in / switch provider
/model [N|substr]List models, or switch
/approval <mode>never · destructive · always
/sessionsSearchable session picker
/newFresh session (keeps the old)
/compactCompact context now
/attachAttach an image (vision)
/abortStop the running turn
When ⚠ APPROVE? shows:y approve once · a always for this tool · n deny.
Next

Read the docs

Providers, subagents, the approval gate, and the protocol.

Docs