supacode-cli

name	supacode-cli
description	Control Supacode from the terminal. Use when running Supacode CLI commands, managing worktrees, tabs, and surfaces programmatically, or when inside a Supacode terminal session.
version	1.0.0
cluster	agentic-ops

Supacode CLI

Control Supacode from the terminal. The supacode command is available in all Supacode terminal sessions.

CRITICAL: ID Tracking

NEVER call supacode tab new or supacode surface split without capturing the output. They print the new UUID to stdout. Without it you cannot target the resource afterward.

NEVER omit -t/-s when targeting a created resource. The env vars point to your own shell, not to anything you created.

For new tabs, surface ID = tab ID.

Correct:

TAB_ID=$(supacode tab new -i "npm start")
SPLIT_ID=$(supacode surface split -t "$TAB_ID" -s "$TAB_ID" -d v -i "npm test")
supacode surface close -t "$TAB_ID" -s ""
supacode tab close -t