chubes.net

Home

Project: Homeboy

Self-improving codebase management system.

Homeboy CLI documentation

This directory contains the markdown docs embedded into the homeboy binary and displayed via homeboy docs. Homeboy is a config-driven automation engine for development and deployment automation, with standardized patterns...

January 26, 2026 Read More

`homeboy upgrade`

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

January 26, 2026 Read More

`homeboy version`

Synopsis homeboy version <COMMAND> Subcommands show homeboy version show [<component_id>] Shows the current version for the specified component, or the Homeboy binary version if omitted. bump homeboy version bump <component_id>...

January 26, 2026 Read More

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

January 26, 2026 Read More

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

January 26, 2026 Read More

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

January 26, 2026 Read More

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

January 26, 2026 Read More

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

January 26, 2026 Read More

`homeboy release`

Synopsis homeboy release <COMPONENT> <BUMP_TYPE> [OPTIONS] Where <BUMP_TYPE> is patch, minor, or major. Also available as: homeboy version bump <COMPONENT> <BUMP_TYPE> [OPTIONS] Options --dry-run: Preview the release plan without executing...

January 26, 2026 Read More

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

January 26, 2026 Read More
← Back to Chubes.net