Configuration

Configure project identity, tmux isolation, workspace strategy, restart policy, adapters, and approval conventions.

Project configuration

clishake init creates .clishake/config.toml. This is the one file inside .clishake/ intended for version control.

.clishake/config.toml

[project]
name = "my-project"

[tmux]
socket = "clishake"
session_prefix = "clishake-"

[defaults]
adapter = "mock"
workspace = "worktree-per-agent"

[restart]
mode = "on-failure"
max_restarts = 3
backoff_ms = 1000
window_sec = 60

[approval]
require_for = ["merge", "delete_files", "access_secrets"]

Adapter options

Generic TUI behavior can be tuned without forking an adapter. Useful options include command, args, ready_marker, enter_delay_ms, and settle_ms.

.clishake/config.toml

[adapters.opencode]
command = "opencode"
args = []

[adapters.opencode.options]
ready_marker = "Ask anything"
enter_delay_ms = 400
settle_ms = 2500

Environment

CLISHAKE_PROJECTTarget a session project from any directoryCLISHAKE_AGENTAttribute agent-run CLI commandsCLISHAKE_NO_UPDATE_CHECKDisable the cached daily update check