terminal-context

Skill dający agentom AI (Claude, Copilot) pełny dostęp do stanu terminala Kitty: listowanie paneli i zakładek, czytanie historii, mapowanie portów na procesy, parsowanie metadanych gita i ostatnich komend z hooków shell'a. Zamiast ręcznego kopiowania — automatycznie pobieraj kontekst z innych paneli, wysyłaj komendy i śledź ich wykonanie. Idealne gdy pytasz agenta "czy serwer działa" lub "co się nie powiodło".

1. Zainstaluj skill terminal-context w swoim środowisku agenta (Claude/Copilot/Codex). Upewnij się, że masz zainstalowany terminal Kitty i dostęp do repozytorium https://github.com/aelaguiz/kitty_skills.

2. Skonfiguruj Kitty socket i shell hooks — włącz opcję listen_on w konfiguracji Kitty i zainstaluj shell hooks zgodnie z dokumentacją w references/SETUP.md. To umożliwi agentowi deterministyczne odczytywanie stanu terminala.

3. Zacznij od pobrania kontekstu: poproś agenta o uruchomienie tc-context --summary, aby zobaczył wszystkie otwarte panele, zakładki i bieżące katalogi robocze.

4. Gdy chcesz przeanalizować błędy — użyj tc-output --cwd "$PWD" --lines 120 --match "error|failed|traceback", aby agent automatycznie wyszukał i wyświetlił istotne wiersze z historii terminala.

5. Aby agent wysłał komendę do innego panela, użyj tc-send --cwd "$PWD" "npm test" — agent najpierw przeczyta kontekst panela, potwierdzi katalog roboczy, a dopiero wtedy wyśle komendę.

6. Do monitorowania procesów (np. czekania na serwer) — użyj tc-watch --cwd "$PWD" "ready|listening|compiled" --timeout 90, aby agent śledził output w tle i powiadomił Cię, gdy pojawi się szukana fraza.