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 in crates/homeboy-cli, so it cannot drift from the binary.
Hand-written narrative lives in the commands index. Global flags are documented in the root command reference. Machine-readable safety, docs, output, and Lab metadata come from homeboy contract manifest.
| Command | Reference | Summary |
|---|---|---|
homeboy activity | activity.md | Unified view of active and recently finished Homeboy work |
homeboy agent-task | agent-task.md | Run generic agent task plans |
homeboy deferred-workload | deferred-workload.md | Resume portable workloads deferred until a runner is ready |
homeboy project | project.md | Manage project configuration |
homeboy ssh | ssh.md | SSH into a project server or configured server |
homeboy server | server.md | Manage SSH server configurations |
homeboy bench | bench.md | Run performance benchmarks for a component |
homeboy fuzz | fuzz.md | Run generic fuzz workloads for a component |
homeboy trace | trace.md | Capture black-box behavioral traces for a component |
homeboy observe | observe.md | Passively observe a running system and persist timeline evidence |
homeboy db | db.md | Database operations |
homeboy deps | deps.md | Manage component dependencies |
homeboy file | file.md | Remote file operations |
homeboy fleet | fleet.md | Manage fleets (groups of projects) |
homeboy logs | logs.md | Remote log viewing |
homeboy triage | triage.md | Attention reports and watch utilities for components, projects, fleets, and rigs |
homeboy deploy | deploy.md | Deploy components to remote server |
homeboy harvest | harvest.md | Recover remote component content into local Git history |
homeboy component | component.md | Manage standalone component configurations |
homeboy config | config.md | Manage global Homeboy configuration |
homeboy contract | contract.md | Inspect, export, validate, and normalize Homeboy contract metadata |
homeboy daemon | daemon.md | Run the local-only HTTP API daemon |
homeboy extension | extension.md | Execute CLI-compatible extensions |
homeboy schedule | schedule.md | Declare homeboy commands that run on a cadence |
homeboy status | status.md | Actionable component status overview |
homeboy cleanup | cleanup.md | Remove declared reconstructable artifacts from managed worktrees |
homeboy git | git.md | Git operations for components |
homeboy release | release.md | Plan release workflows |
homeboy report | report.md | Render reports from Homeboy structured output artifacts |
homeboy review | review.md | Run scoped audit + lint + test umbrella against PR-style changes |
homeboy refactor | refactor.md | Structural refactoring (rename terms across codebase) |
homeboy rig | rig.md | Manage local dev rigs (reproducible multi-component environments) |
homeboy runner | runner.md | Manage local and SSH execution runners |
homeboy runtime | runtime.md | Inspect core-owned runtime helper assets |
homeboy worktree | worktree.md | Manage component-backed task worktrees |
homeboy tunnel | tunnel.md | Manage private service tunnel declarations |
homeboy runs | runs.md | Inspect persisted observation runs and artifacts |
homeboy self | self.md | Inspect the active Homeboy binary and install signals |
homeboy stack | stack.md | Manage stacks (combined-fixes branches built from base + cherry-picked PRs) |
homeboy api | api.md | Make API requests to a project |
homeboy upgrade | upgrade.md | Upgrade Homeboy to the latest version |
Commands shipping without help text
40 visible commands declare no clap about/long_about, so no description can be generated for them. The fix is a doc comment on the clap variant, not prose in this file.
homeboy agent-task doctorhomeboy agent-task loophomeboy agent-task loop definehomeboy agent-task loop statushomeboy agent-task loop resumehomeboy agent-task loop stophomeboy agent-task run-planhomeboy agent-task runhomeboy agent-task run-nexthomeboy agent-task submithomeboy agent-task statushomeboy agent-task listhomeboy agent-task activehomeboy agent-task reconcile-recordshomeboy agent-task latesthomeboy agent-task logshomeboy agent-task artifactshomeboy agent-task evidencehomeboy agent-task diagnosehomeboy agent-task replay-provider-boundaryhomeboy agent-task cancelhomeboy agent-task resumehomeboy agent-task retryhomeboy agent-task fanouthomeboy agent-task fanout planhomeboy agent-task fanout submithomeboy agent-task fanout submit-batchhomeboy agent-task fanout statushomeboy agent-task fanout artifactshomeboy agent-task fanout run-planhomeboy agent-task reviewhomeboy agent-task promotehomeboy agent-task finalize-prhomeboy agent-task gate-feedbackhomeboy agent-task providershomeboy agent-task promptshomeboy agent-task contracthomeboy agent-task compile-loophomeboy agent-task authhomeboy agent-task controller