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://catalyst-code.dev/install.sh | bash

→ Core built natively; embedded into the TUI via go:embed

installed✓

Artifacts

catcode-linux-x86_64 (standalone)catcode-x86_64.AppImage

Core built natively; embedded into the TUI via go:embed. Sandboxing (firejail / --no-network) is Linux-only.

macOS

macos — bash

$curl -fsSL https://catalyst-code.dev/install.sh | bash

→ Apple Silicon + Intel

installed✓

Artifacts

catcode-macos-arm64 (standalone)catcode-macos-arm64.dmg

Apple Silicon + Intel. Standalone extracts its core to ~/Library/Caches on first run. DMG installs to /usr/local/bin.

Windows

windows — bash

$irm https://catalyst-code.dev/install.ps1 | iex

→ MSI adds catcode to PATH with no admin

installed✓

Artifacts

catcode-windows.msi (per-user)catcode-windows-x86_64.exe (standalone)

MSI adds catcode to PATH with no admin. Standalone embeds the core. bash tool needs Git Bash or WSL.

Build from source

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

bash — build

$git clone https://github.com/catalyst-code/catalyst-code.git catalyst-code

$cd catalyst-code

$cd core && cargo build --release

→ core/target/release/core

$cd ../tui && go build -o tui

→ tui/tui

$./tui/tui

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.

Read the docs

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

Docs