Options

🚀Options

Recommended

Learn about the available command-line options for project validation.

Commandcusty validate

📦Category

Validation

🚀Quick Command

custy validate

---

optionsvalidationcli

---

Overview

The validation command supports several command-line options that influence how validation is performed.

Some options change the validation behavior, while others determine how Custy interacts with the project during the validation process.

💡Configuration First

Most validation behavior is controlled by your project's

.config/custy/config.toml configuration.

Command-line options temporarily override those configuration values for the current execution.

---

Available Options

⚙️Command Options

Available command-line options.

--skip-checks

Optional

---

Skip optional validation checks when supported by the current workflow.

Defaultfalse

Examplecusty validate --skip-checks

--force-commit

Optional

---

Continue validation even when no staged changes are available.

Defaultfalse

Examplecusty validate --force-commit

--auto-stage

Optional

---

Automatically stage modified files before validating staged changes.

Defaultfalse

Examplecusty validate --auto-stage

--stage-mode

Optional

---

Choose how automatic staging is performed.

Defaultall

Examplecusty validate --stage-mode update

---

Option Priority

When determining validation behavior, Custy resolves values using the following order of precedence.

1. Command-line options.
2. Project configuration (config.toml).
3. Built-in Custy defaults.

This allows projects to define sensible defaults while still allowing individual executions to override specific settings.

---

ℹ️Workflow Commands

When validation is executed as part of a workflow, some options may already be supplied by the workflow configuration.

In those cases, manual command-line options override the configured defaults for the current execution only.

---

What's Next?

The next page explains every validation step performed by Custy and the purpose of each check.