Commands
Command Documentation
This directory contains hand-written command concepts, workflows, and operational contracts. It intentionally does not duplicate Clap's generated syntax. Use homeboy...
homeboy trace
Capture black-box behavioral traces for a component by executing declared scenarios. Trace runners write a JSON evidence envelope plus optional...
`homeboy deploy`
Synopsis homeboy deploy [<project_id>|<component_id>] [<component_ids...>] [-p|--project <id>] [-c|--component <id>]... [--all] [--outdated|--behind-upstream] [--head|--ref <git-ref-or-sha>] [--release-set <path>] [--check] [--dry-run] [--confirm-dangerous] [--json '<spec>']...
Source
Inspect a controller-local directory against the exact sealed source-package scanner used by Lab staging, before starting an expensive workflow: homeboy...
`homeboy self`
Inspect the active Homeboy binary and nearby install/update signals. Synopsis homeboy self <COMMAND> Subcommands status — report the active binary,...
`homeboy rig`
Manage local dev rigs: reproducible multi-component environments that can start services, prepare checkouts, sync combined-fixes stacks, run health checks, and...
`homeboy config`
Manage global Homeboy configuration stored under the OS config directory as ~/.config/homeboy/homeboy.json. Overview The homeboy config command provides access to...
`homeboy ssh`
Synopsis # Non-interactive discovery (JSON output): homeboy ssh list # Connect (interactive when no COMMAND is provided): homeboy ssh [OPTIONS]...
Audit Layer Ownership Rules
Homeboy audit supports optional architecture/layer ownership rules to catch design-level drift that passes lint/static checks. Rule file locations Use one...
Review Command
Run scoped audit + lint + test in a single invocation against PR-style changes. review also owns the individual quality...
`homeboy triage`
Produce an attention report for components, projects, fleets, rigs, or the full configured workspace. Snapshot report mode reads GitHub state...
Rig Spec Reference
JSON reference for rig specs loaded from ~/.config/homeboy/rigs/<id>.json or installed from a rig package. Package Layout A rig package can...