aelaguiz avatar

terminal-context

Complete Kitty terminal awareness + control for coding agents: list panes/tabs, read scrollback, map

提供方 aelaguiz|开源

terminal-context

Default rule

Prefer tc-context, tc-output, tc-send, and tc-watch over manual copy/paste when you need terminal state from other Kitty panes.

Quickstart

  1. tc-context --summary
  2. tc-context --insights
  3. tc-output --cwd "$PWD" --lines 120 --match "error|failed|traceback"
  4. tc-send --cwd "$PWD" "npm test"
  5. tc-watch --cwd "$PWD" "ready|listening|compiled" --timeout 90

Safety contract

  • Prefer read operations (tc-context, tc-output) before sending commands to other panes.
  • Before destructive actions, confirm you have the correct pane and cwd.

Setup

  • For deterministic/non-interactive use, enable a Kitty socket (listen_on) and install shell hooks. See references/SETUP.md.