Skip to main content

User Guide

User Guide

Task-Oriented

Follow practical, review-first journeys for the work you want to complete with Custy.

Commandcusty

Category

User Guide

Quick Command

prepare -> preview -> execute -> verify

daily workreleasesmaintenancerecovery

Overview

This guide organizes Custy around real tasks rather than individual command options. Each journey explains what to prepare, which command or profile to choose, what can change, how to verify success, and what to inspect when a run stops partway through.

Use the Command Reference when you need every option. Use Configuration for persistent project policy, and Pipelines for exact internal execution order.


Choose Your Journey

Common Custy Work

Everyday Development

Review the commit message, then commit and push branch work without release side effects through the Dev journey.

Preparing Releases

Move from release readiness through version, changelog, commit, tag, and publication in the Release journey.

Managing Backups

Protect commit and tag message files and apply retention deliberately in the Backup journey.

Cleaning Branches

Preview layered branch filters before deleting local and remote branches in the Cleanup journey.

Choosing a Command

Use the Command Reference when one focused operation is safer than a full profile.

Start with Repository State

Reusable preflight
bash
git status --short --branch
git diff
git diff --staged
git remote -v
custy validate

These checks answer four questions before Custy mutates anything: which branch is active, which changes exist, which changes are staged, and where remote operations can go.



Continue