Architecture
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,...
Provider fanout boundary
Homeboy core owns durable orchestration and provider-neutral evidence. Runtime providers own backend-specific fanout execution. The seam is the AgentTaskRequest/AgentTaskOutcome adapter...
Agent task executor adapter
Agent task executor adapters are the boundary between Homeboy core and the systems that actually run agent work. Core owns...
Structured Sidecars
Homeboy core owns the structured sidecar registry used by extension runners. Extension manifests declare support with structured_sidecars. Boolean declarations use...
Runner contract
The contract between Homeboy core and runner scripts: what capabilities exist, what env vars flow in, what sidecar files scripts...
Rig Matrix Axis Composition
Design for deriving rig variants from one base rig plus explicit axis overlays. Status: design proposal. homeboy rig matrix and...
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...
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...
API Client System
The API client provides HTTP request capabilities with template-based authentication per project. Overview Homeboy projects can configure an API client...
Keychain and Secrets Management
Homeboy securely stores sensitive credentials using OS-native keychain/credential manager systems. Overview Homeboy never stores secrets in plaintext configuration files. All...
JSON output contract
Homeboy prints JSON to stdout for most commands. Exceptions: homeboy docs prints raw markdown (or newline-delimited topic names for homeboy...