ls-liteharness

Community

Orchestrate Claude Code sessions headlessly or with UI control.

Authorahostbr
Version1.0.0
Installs0

System Documentation

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'."

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ls-liteharness
Download link: https://github.com/ahostbr/liteharness/archive/main.zip#ls-liteharness

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.