aelaguiz / terminal-context

Skill Content

---
name: terminal-context
description: >-
  Complete Kitty terminal awareness + control for coding agents: list panes/tabs,
  read scrollback, map ports→processes, parse per-pane git/last-command metadata
  (from shell hooks), and send commands/focus panes. Use when user mentions
  "another terminal", "is the server running", "what failed", or you need to
  run/inspect commands across panes.
---

# 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`.