Reference
Configuration Reference
This page is a field-level reference for Homeboy configuration structures. For the higher-level system model and core/extension boundary, see Architecture...
Release Set Manifest
A release set is a caller-supplied, product-agnostic source-membership contract. It is versioned by schema and has a deterministic SHA-256 identity...
Reference
Reference docs describe exact command behavior, configuration fields, schemas, templates, and output contracts. Use workflows first when you need a...
Template Variables
Homeboy supports template variables in several contexts. Both single-brace ({var}) and double-brace ({{var}}) syntaxes are supported everywhere for backward compatibility....
`homeboy` root command
Synopsis homeboy [OPTIONS] <COMMAND> Description homeboy is headless automation for agentic software engineering workflows. It keeps local developers, CI, scheduled...
Homeboy CLI reference (generated)
homeboy exposes 536 visible commands across 41 top-level command families. Every page below is generated from the clap command tree...
`homeboy runner` command reference
Generated from the clap command tree. This page is the complete synopsis, argument, flag, and subcommand surface for this command...
`homeboy agent-task` command reference
Generated from the clap command tree. This page is the complete synopsis, argument, flag, and subcommand surface for this command...
`homeboy worktree` command reference
Generated from the clap command tree. This page is the complete synopsis, argument, flag, and subcommand surface for this command...
`homeboy upgrade` command reference
Generated from the clap command tree. This page is the complete synopsis, argument, flag, and subcommand surface for this command...
`homeboy status` command reference
Generated from the clap command tree. This page is the complete synopsis, argument, flag, and subcommand surface for this command...
Extension Manifest Schema
Extension manifests define extension metadata, runtime behavior, platform behaviors, and integration points. Stored as <extension_id>/<extension_id>.json in the extension directory. Extension...
Project Schema
Project configuration defines environment-specific context stored in projects/<id>.json: server bindings, domains, local paths, remote paths, project-scoped CLI settings, API settings,...
Portable Component Config (`homeboy.json`)
A homeboy.json file in a repo root defines portable component configuration that travels with the code. Clone a repo, run...
Configuration Schemas
Schemas document Homeboy configuration structures. For overlapping configuration concepts and runtime precedence, see Configuration precedence map. Component schema Project schema...
Component Schema
Component configuration defines buildable and deployable units stored in components/<id>.json. Schema { "id": "string", "name": "string", "local_path": "string", "remote_path": "string",...
Server Schema
Server configuration defines SSH server connections stored in servers/<id>.json. Schema { "id": "string", "name": "string", "host": "string", "port": number, "user":...