Agent skill

kitty-remote

Control kitty terminal via remote protocol and kitty-test-harness; launch panels/windows, send keys, capture screen, manage sockets, and debug remote-control failures when testing TUIs.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/kitty-remote

Metadata

Additional technical details for this skill

triggers 
{
    "type": "domain",
    "keywords": [
        "kitty",
        "kitty test"
    ],
    "priority": "high",
    "enforcement": "suggest"
}

SKILL.md

Kitty Remote Control

Drive kitty instances via the remote control protocol and kitty-test-harness.

Prerequisites

  • Ensure kitty is installed and on PATH.
  • Enable remote control (allow_remote_control=yes in kitty.conf or via -o).
  • Run under an active Wayland or X11 session.

Quick start

  1. Launch kitty with a unix socket (--listen-on unix:/abs/path.sock or KITTY_LISTEN_ON).
  2. Wait for @ ls to succeed before sending input.
  3. Send input with send-text and capture output with get-text --extent screen.
  4. Close with close-window and remove the socket.

Harness usage

  • Prefer kitty +kitten panel on Wayland; fall back to windows on X11/WSL
  • Use absolute socket paths; delete stale sockets before launch
  • Send ESC to normalize modal state before : commands
  • Socket disappearance = app exit/crash; capture with @ ls, get-text --ansi, logs
  • Source scripts/kitty-harness.sh for ready-to-use harness

References

  • harness-notes.md - internals, failure signatures, debug flow
  • escape-codes.md - byte-level key sequences and modifiers

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results