Local Installation

Run cc-deck directly on your machine with Zellij. This is the simplest setup and requires no containers.

Prerequisites

  • Zellij 0.43 or later

  • Go 1.22 or later (for building from source)

  • Rust stable with the wasm32-wasip1 target (for building the plugin)

Install

Clone the repository and build everything:

git clone https://github.com/cc-deck/cc-deck.git
cd cc-deck
make install

make install builds the WASM plugin, compiles the Go CLI, and runs cc-deck plugin install to set up Zellij layouts and Claude Code hooks.

What Gets Installed

The installer places files in your Zellij configuration directory:

File Purpose

~/.config/zellij/plugins/cc_deck.wasm

The sidebar plugin binary.

~/.config/zellij/layouts/cc-deck.kdl

Default layout (set to the selected variant).

~/.config/zellij/layouts/cc-deck-standard.kdl

Standard layout with sidebar, tab bar, and status bar.

~/.config/zellij/layouts/cc-deck-minimal.kdl

Minimal layout with sidebar and compact bar.

~/.config/zellij/layouts/cc-deck-clean.kdl

Clean layout with sidebar only.

~/.claude/settings.json

Claude Code hooks for session tracking (merged, not overwritten).

Start

zellij --layout cc-deck

Or set cc-deck as your default layout in ~/.config/zellij/config.kdl:

default_layout "cc-deck"

Then simply running zellij starts with the cc-deck sidebar.

Install Options

The cc-deck plugin install command accepts several flags:

--force / -f

Overwrite existing files without prompting.

--skip-backup

Skip the timestamped backup of settings.json.

--layout <variant>

Set the default layout variant. Options: standard (default), minimal, clean.

--install-zellij

Download and install a matching Zellij binary.

Verify

cc-deck plugin status

This shows the installed plugin version and layout configuration.

Uninstall

cc-deck plugin remove

This removes the plugin, layouts, and hooks.

Next Steps