What problem does it solve?
Coordinating multiple AI coding agents (Claude Code, Codex, opencode) requires a way for one agent to spawn, prompt, and read another agent running in a terminal. This Skill provides the create→send→snapshot loop for driving a terminal-based agent from the outside without standing up a server or MCP layer.
Core Features & Use Cases
- Terminal Agent Control: Spawn a coding agent in a PTY with
kaval-tui create, type prompts with send, submit with a separate send --key Enter, and read replies via snapshot --viewport.
- Done-Signal Detection: Poll the screen until it settles for raw terminals, or use
pulam-tui wait --until for precise agent-state detection on hooked terminals.
- Local and Remote Reach: Autodiscover a local daemon, target a kolu-server socket, or drive a daemon on another machine over SSH with
--host.
- Use Case: Have a supervising Claude agent spawn a Codex session, assign it a refactoring task, wait for its turn to finish, read the result, and issue follow-up prompts in a loop.
Quick Start
Use the kolu skill to spawn a Claude Code session in a terminal, send it a prompt to refactor the parser, wait for its reply, and read the response from the screen.