What problem does it solve?
LiteHarness eliminates the friction of manually spawning, identifying, messaging, and controlling coding-agent terminal sessions across multiple CLIs by providing a consistent orchestration layer.
Core Features & Use Cases
- Session startup and self-registration: Ensures every spawned agent activates the correct inbox watcher (per CLI surface) and can receive messages reliably.
- Deterministic agent naming + discovery: Generates stable two-word names from agent UUIDs to make monitoring and routing easier when managing many sessions.
- PTY daemon and headed UIAutomation modes: Supports headless programmatic control for fast workflows, plus headed terminal control when visible UI automation is required.
- Inbox-based messaging + lifecycle commands: Uses a Maildir-style inbox for message delivery and supports safe task rotation with /clear (while blocking /exit for safety).
Quick Start
Ask the system to spawn a headless agent and register it: "Spawn a new LiteHarness-controlled agent in headless PTY mode with model haiku, named Worker, that runs the prompt 'run the tests'."