Docs/Getting started

Quickstart

Install clishake, open the dashboard, and get a builder and reviewer collaborating in a few minutes.

Prerequisites

clishake is deliberately local and terminal-native. Before installing, make sure these are available:

  • tmux 3.0+Required for durable agent terminals
  • Homebrew or Go 1.24+Choose your installation path
  • GitRecommended for per-agent worktrees

Agent CLIs are optional. The built-in mock adapter works without any external AI service.

Platform support

SUPPORTED

macOS

Apple Silicon and Intel

SUPPORTED

Linux

x86-64 and ARM

VIA WSL2

Windows

Native support is planned

Windows today

clishake orchestrates through tmux, which is not native to Windows. Run clishake inside WSL2, where it behaves as it does on Linux.

1. Install

terminal
# Homebrew
$ brew install --cask clishakehq/clishake/clishake

# Or install with Go
$ go install github.com/clishakehq/clishake/cmd/clishake@latest

To build from source instead:

terminal
$ git clone https://github.com/clishakehq/clishake
$ cd clishake && make install

2. Initialize a project

Run one command inside any Git repository. It creates .clishake/ and opens the interactive dashboard.

~/your-project
$ clishake init
Safe to commit

Runtime state, logs, context files, and worktrees are ignored automatically. .clishake/config.toml remains committable.

3. Add your agents

Use dashboard commands or the scriptable CLI. Here, Claude builds while Codex reviews:

terminal
$ clishake agent add claude --adapter claude-code \\
    --role builder --task "Implement the API changes"

$ clishake agent add codex --adapter codex \\
    --role reviewer --task "Review backend changes"

Each editing agent gets a dedicated worktree and branch such as clishake/claude. Read-only reviewers remain in the project root by default.

4. Coordinate the work

terminal
# Direct message
$ clishake send @claude "implement the login endpoint"

# Route to a role or everyone
$ clishake send @role:reviewer "inspect auth changes"
$ clishake broadcast "status?"

# Record a shared decision
$ clishake note "integration goes through the lead"

The dashboard exposes the same controls with four views: overview, focus, live terminal grid, and filterable attributed chat.

Where to go next