terminal-context
Controls and monitors Kitty terminal sessions directly from your coding agent.
Install
mkdir -p .claude/skills/terminal-context && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/426" && unzip -o skill.zip -d .claude/skills/terminal-context && rm skill.zipInstalls to .claude/skills/terminal-context
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →List active Kitty terminal tabs and panes
- →Inspect scrollback buffer content across panes
- →Map open network ports to running processes
- →Parse per-pane shell command metadata
- →Send remote commands to specific terminal panes
How it works
It uses a local Kitty socket to query the window manager's state and inject commands into specific terminal pane instances.
Inputs & outputs
When to use terminal-context
- →Identify which terminal pane is running a dev server
- →Inspect error logs in a specific tab's scrollback
- →Execute tests across multiple terminal windows
- →Restart processes based on port conflicts
About this skill
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
tc-context --summarytc-context --insightstc-output --cwd "$PWD" --lines 120 --match "error|failed|traceback"tc-send --cwd "$PWD" "npm test"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. Seereferences/SETUP.md.
When not to use it
- →Standard GUI terminal windows
- →Local machine without Kitty terminal
Prerequisites
Limitations
- →Only compatible with Kitty terminal
- →Requires shell hooks for full metadata
- →Execution depends on socket permissions
How it compares
It provides programmatic control over the terminal environment rather than operating solely through manual user interaction.
Compared to similar skills
terminal-context side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| terminal-context (this skill) | 5 | 7mo | Review | Advanced |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| openspec-onboard | 10 | 6mo | Review | Beginner |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-sync
KyleKing
Syncs Claude Skills with other AI coding tools like Cursor, Copilot, and Codeium by creating cross-references and shared knowledge bases. Invoke when user wants to leverage skills across multiple tools or create unified AI context.
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.