Commands

cctabs (default)

Running cctabs with no arguments is equivalent to cctabs sessions.

cctabs sessions

List all tabs with session status.

cctabs sessions

Output:

Sessions
==================================================

Workspace: work (current)

  [a1b2c3d4] "auth" ◄  ~/Dev/myapp
    ● active
  [e5f6a7b8] "api"  ~/Dev/myapp
    ○ idle
  [c9d0e1f2] "infra"  ~/Dev/myapp
      terminal
    last: $ git status

Status values:

• ● active — Claude Code UI detected in scrollback
• ○ idle — claude in last line but no active UI
• terminal — plain shell, no Claude running

cctabs list

List all workspaces, tabs, and blocks with IDs.

cctabs list

cctabs new

Open a new tab and launch claude.

cctabs new <name> [dir] [-w workspace]

Argument	Description
name	Tab name (required)
dir	Working directory (default: current)
-w, --workspace	Target Wave workspace

cctabs resume

Open a new tab and run claude --continue.

cctabs resume <name> [dir]

cctabs fork

Fork a session into a new tab using claude --resume <session-id> --fork-session.

cctabs fork <tab-name> [-n new-name]

Argument	Description
tab-name	Source tab (name or ID prefix)
-n, --name	Name for the new tab (default: <source>-fork)

cctabs close

Close a tab by name or ID prefix.

cctabs close <name-or-id>

cctabs rename

Rename a tab.

cctabs rename <name-or-id> <new-name>

cctabs scrollback

Read terminal output for a tab or block.

cctabs scrollback <tab-or-block> [lines]

Default: last 50 lines. Accepts a tab name, tab ID prefix, or block ID prefix.

cctabs send

Send input to a tab or terminal block.

cctabs send <tab-or-block> [text] [--file <path>]

Source	Example
Inline text	cctabs send auth "yes\n"
File	cctabs send auth --file ~/prompts/task.txt
Stdin	echo "do the thing" | cctabs send auth

Escape sequences in inline text: \n = Enter, \t = Tab.

Accepts a tab name (resolves to its first terminal block), or a block ID prefix.

cctabs config

Show the config file path and current values.

cctabs config

cctabs doctor

Diagnose Wave Terminal DB issues — currently the orphan-tabid bug that breaks wsh blocks list. See Troubleshooting for the full background.

cctabs doctor              # diagnose only
cctabs doctor --fix        # back up the DB and apply the fix interactively
cctabs doctor --fix --yes  # skip the confirmation prompt