watch

schmug's avatarfrom schmug

Launch the Karkinos TUI to monitor worker progress in a new terminal window.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[Monitoring]

When & Why to Use This Skill

The Karkinos Watch skill provides a dedicated Terminal User Interface (TUI) for real-time monitoring of worker progress. It enhances developer productivity by spawning a separate terminal window to track background tasks and system performance, ensuring high visibility into distributed processes without interrupting the primary coding environment.

Use Cases

  • Real-time Progress Tracking: Launch a dedicated TUI to visualize the live status and completion rates of active Karkinos workers during complex task execution.
  • Performance Bottleneck Identification: Monitor worker activity in a separate terminal pane to quickly identify stalled processes or resource-heavy tasks.
  • Multi-terminal Workflow Management: Maintain a persistent view of system health and worker logs while continuing to interact with Claude Code or other development tools in the main terminal.
namewatch
descriptionLaunch the Karkinos TUI to monitor worker progress in a new terminal window.
allowed-toolsBash

Watch Skill

Launch the Karkinos worker monitor TUI in a new terminal window.

Usage

/karkinos:watch

Instructions

When the user invokes /karkinos:watch, follow these steps:

1. Check if karkinos CLI is installed

which karkinos || echo "NOT_FOUND"

2. If installed, spawn the TUI

karkinos watch --spawn

This opens the TUI in a new Terminal window (macOS) or terminal emulator (Linux).

3. If not installed, provide instructions

Tell the user:

The karkinos CLI is not installed. Install it with:

  uv tool install karkinos

Or if you have the source:

  uv tool install /path/to/karkinos

Then run: karkinos watch --spawn

Notes

  • The TUI must run in a separate terminal from Claude Code
  • Use --spawn to automatically open a new terminal:
    • VS Code/Cursor: Splits the current terminal pane
    • Terminal.app: Opens a new window
    • Linux: Opens gnome-terminal, xterm, or konsole
  • Use --no-crabs to disable the animated crab header
  • Use --speed 0.2 for faster animation