CLI Guide

The termdock command-line tool, keyboard shortcuts, and terminal operations for efficient workflow.

The termdock CLI

Since v1.11, Termdock ships a termdock CLI that talks to the running app through a local control socket and the Terminal API. Use it from any shell — including shells running inside Termdock itself — to identify, create, and control sessions, manage the pane layout, and install AI agent hooks.

Identity & host detection

termdock identify --json      # focused workspace/pane/session identity
termdock hostinfo --json      # detect host terminal (multi-signal, offline)

Sessions (v1.12+)

termdock session create --workspace <id> [--name <name>] [--background] --json
termdock session list --json
termdock session output <id> [--mode raw|text|content|screen] [--lines <n>] --json
termdock session output <id> --follow          # stream output live
termdock session input <id> <text> [--enter] --json
termdock session attach <id>                   # attach from your shell
termdock session destroy <id> --json

Layout control (v1.12+)

termdock layout get --json
termdock layout set <type> [--sessions <id,id>] --json
termdock layout assign <pane-id> <session-id|none> --json
termdock layout activate <pane-id> --json

Agent hooks & Workstream (v1.13+)

termdock hooks status [--agent claude|codex|gemini] [--json]
termdock hooks setup [--agent claude|codex|gemini] [--dry-run]
termdock hooks uninstall [--agent claude|codex|gemini] [--dry-run]
termdock hook ingest --json [--wait]           # bridge provider hooks

hooks setup installs provider hooks so agent permission prompts, questions, and exit plans surface in the Workstream panel, where you can reply without switching terminals. --dry-run previews changes without writing.

Global options

--help, -h           Show help text
--version, -v        Show the Termdock CLI version
--url <url>          Terminal API base URL
--token <token>      Terminal API bearer token

Keyboard Shortcuts

Terminal Operations

Cmd+TNew terminal tab
Cmd+WClose terminal
Cmd+1/2/3Switch to tab
Cmd+]Next terminal
Cmd+[Previous terminal

Workspace Management

Cmd+PWorkspace selector
Cmd+Shift+FSearch files
Cmd+BToggle sidebar

Application

Cmd+,Open settings

Shell Support

Termdock supports multiple shell environments with automatic detection and configuration.

Zsh

Full Zsh support with custom configuration and enhanced features.

Bash

Cross-platform Bash compatibility with environment preservation.

PowerShell

Windows PowerShell integration for cross-platform development.

Git Integration

Built-in Git operations with visual feedback and conflict resolution.

Git Operations

  • • Click "+" to stage files
  • • Use Cmd+Enter in commit message for quick commit
  • • Visual branch switching and status display
  • • Real-time conflict highlighting