Architecture

CI result JSON contract

Homeboy CI results are exposed through the existing global --output <path> flag. The flag writes the same JSON envelope Homeboy...

Updated April 29, 2026

JSON output contract

Homeboy prints JSON to stdout for most commands. Exceptions: homeboy docs prints raw markdown (or newline-delimited topic names for homeboy...

Updated April 28, 2026

Rig Matrix Axis Composition

Design for deriving rig variants from one base rig plus explicit axis overlays. Tracked by Extra-Chill/homeboy#1844. Problem Rigs currently model...

Updated April 28, 2026

Extension runner contract

The contract between Homeboy core and extension runner scripts: what capabilities exist, what env vars flow in, what sidecar files...

Updated April 27, 2026

Execution Context

Execution context is the environment Homeboy passes to extension runners and extension-backed pipeline steps. Overview When Homeboy executes an extension,...

Updated April 27, 2026

Release Pipeline System

The release pipeline provides configurable, local orchestration for managing component releases without CI/CD systems. Overview Homeboy's release pipeline is a...

Updated April 27, 2026

Hooks System

Homeboy provides a general-purpose hook/event system for lifecycle extensibility. Both components and extensions can declare hooks that run shell commands...

Updated March 16, 2026

Core runner + output parse substrate

This document defines the core primitives introduced for: #460 — extension runner helper contract #464 — generic output parsing primitive...

Updated March 16, 2026

Embedded docs: topic resolution and keys

Homeboy embeds markdown files from docs/ into the CLI binary at build time. In addition, homeboy docs reads documentation provided...

Updated March 10, 2026

API Client System

The API client provides HTTP request capabilities with template-based authentication per project. Overview Homeboy projects can configure an API client...

Updated February 28, 2026

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

Updated February 13, 2026

SSH Key Management

Homeboy manages SSH keys for remote server access, including keychain integration for passphrase management. Overview SSH keys in Homeboy are...

Updated February 13, 2026
← Back to Chubes.net