Architecture
Runner contract
The contract between Homeboy core and runner scripts: what capabilities exist, what env vars flow in, what sidecar files scripts...
Headless Daemon API Contract
Homeboy is CLI-first, but the daemon is the stable local UI and automation surface for clients that should not shell...
Provider fanout boundary
Homeboy core owns durable orchestration and provider-neutral evidence. Runtime providers own backend-specific execution details. The seam is the AgentTaskRequest/AgentTaskOutcome adapter...
Homeboy Core Kernel Investigation
Issue: #13126 Measured at investigate/13126-homeboy-core-kernel based on c56e9f889 plus this report. The investigation treats homeboy-core as the kernel. It does...
JSON output contract
Homeboy prints JSON to stdout for most commands. Exceptions: homeboy self docs prints raw markdown (or newline-delimited topic names for...
Release Pipeline System
Homeboy release automation is a local-first planner/executor for component releases. It turns component metadata, conventional commits, extension release actions, and...
Runner Connection Bootstrap
homeboy runner connect <runner-id> uses the first-class runner registry added for issue #2526. Registry Contract Runner configs are JSON files...
Preview Metadata
Homeboy preserves generic preview metadata and can either consume caller-supplied public access or own a native preview tunnel lifecycle for...
Browser Evidence Schemas
Homeboy core owns the product-neutral browser, profile, and trace evidence schema vocabulary. Extensions can normalize product-specific data into these shapes,...
SSH Key Management
Homeboy manages SSH keys for remote server access, including keychain integration for passphrase management. Overview SSH keys in Homeboy are...
Planned Change Execution
Homeboy's planned-change vocabulary is the shared core language for work that starts as a plan and may eventually mutate files...
Agent task executor adapter
Agent task executor adapters are the boundary between Homeboy core and the systems that actually run agent work. Core owns...