CLI

The CLI lets you interact with a running Claude Yard instance from the terminal. Use it for scripting, automation, or quick commands without switching to the app.

Usage

node cli.mjs <command> [args...]

The CLI reads the server port from the config file. In development, set APP_CONFIG_PATH:

APP_CONFIG_PATH=~/.multi-claude/app-config.dev.json node cli.mjs state

Commands

state

Show current app state — open panels, active sessions, and layout.

node cli.mjs state

spawn

Open a new terminal panel. Spawns a Claude Code session by default.

node cli.mjs spawn              # Claude session
node cli.mjs spawn --shell      # Plain shell

send

Send keystrokes to a terminal panel.

node cli.mjs send <panelId> "hello world"

close

Close a terminal panel.

node cli.mjs close <panelId>

interrupt

Send SIGINT (Ctrl+C) to a terminal panel.

node cli.mjs interrupt <panelId>

layout

Set the panel layout.

node cli.mjs layout split-horizontal
node cli.mjs layout split-vertical

sessions

List all Claude sessions from disk.

node cli.mjs sessions

tools

List all available MCP tools.

node cli.mjs tools