Skip to main content
Format the ledger consistently. This can rewrite ledger formatting. Malformed rows refuse the rewrite; the ledger writer lock must be available.

Example

Formats the local ledger under its writer lock and reports whether it changed. Malformed rows refuse the rewrite.

Options

No command-specific options.

Exit status

0 on success; 2 on usage, configuration, input or request failure.

What happens

Refuses to rewrite a ledger with malformed lines. Uses the ledger mutation lock and prints whether formatting changed.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.