Project Type: Tools

`homeboy upgrade`

Synopsis homeboy upgrade [OPTIONS] Description Upgrades Homeboy to the latest version. The command auto-detects the installation method (Homebrew, Cargo, source build, or downloaded release binary) and runs the appropriate upgrade...

`homeboy version`

Synopsis homeboy version show [<component_id>] [--path <path>] Description homeboy version show is read-only version inspection. It reports the current version for a component discovered from the current directory, an explicit...

Architecture Overview

Homeboy is a development and deployment automation tool built in Rust with a config-driven architecture. Design Principles Single Source of Truth Configuration is the authoritative source for all system behavior....

Config Directory Structure

Important: Homeboy uses centralized configuration only. There is no repo-local config file (no .homeboy.toml or .homeboy directory). All configuration lives in ~/.config/homeboy/. Homeboy stores all configuration in a universal directory...

Error Handling Patterns

Homeboy uses a centralized error system for consistent error reporting across all commands. Error Categories Errors are categorized by type to provide context about what went wrong: Validation Errors Errors...

Documentation Alignment

Instructions for keeping existing .md documentation synchronized with current codebase implementation. Scope Alignment covers documentation that describes current implementation only. Planning documents (describing future work, architectural plans, etc.) are excluded....

`homeboy logs`

Synopsis homeboy logs <COMMAND> Subcommands list <project_id> show <project_id> <path> [-n|--lines <lines>] [-f|--follow] clear <project_id> <path> search <project_id> <path> <pattern> [options] search homeboy logs search <project_id> <path> <pattern> [options] Options:...

`homeboy project`

Synopsis homeboy project [OPTIONS] <COMMAND> Common Workflows Linking Components to a Project After creating components, link them to a project: # Add components to existing project homeboy project components add...

`homeboy release`

Synopsis homeboy release [OPTIONS] [COMPONENTS]... By default Homeboy auto-detects the bump from commit history. Use --bump <major|minor|patch|VERSION> to force a bump type or explicit version. Legacy positional bump syntax is...

`homeboy server`

Synopsis homeboy server <COMMAND> Subcommands create homeboy server create [--json <spec>] [--skip-existing] <id> --host <host> --user <user> [--port <port>] - `--port` defaults to `22`. - When `--json` is provided, CLI...

← Back to Chubes.net