# Terminal Context

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

- Skill: `majiayu000/terminal-context` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/terminal-context`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/terminal-context/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/terminal-context

---


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