<!-- @generated by usage-cli from usage spec -->

# `hk`

**Usage**: `hk [FLAGS] <SUBCOMMAND>`

**Version**: 1.55.0

- **Usage**: `hk [FLAGS] <SUBCOMMAND>`

## Global Flags

### `--cd <DIRECTORY>`

Run as if hk was started in this directory

### `-j --jobs <JOBS>`

Number of jobs to run in parallel

### `-p --profile… <PROFILE>`

Profiles to enable/disable prefix with ! to disable e.g. --profile slow --profile !fast

### `-s --slow`

Shorthand for --profile=slow

### `-v --verbose…`

Enables verbose output

### `-n --no-progress`

Disables progress output

### `-q --quiet`

Suppresses non-essential output (info messages, progress indicators). Failed-step diagnostics are still shown

### `--silent`

Suppresses all output including warnings. Only errors are shown

### `--trace`

Enable tracing spans and performance diagnostics

### `--json`

Output in JSON format

## Flags

### `--format <FORMAT>`

Select human or machine-readable execution output

**Choices:**

- `human`
- `json`
- `jsonl`

**Default:** `human`

## Subcommands

- [`hk agent <SUBCOMMAND>`](/cli/agent.md)
- [`hk agent hooks <--target <TARGET>>`](/cli/agent/hooks.md)
- [`hk agent instructions <--target <TARGET>>`](/cli/agent/instructions.md)
- [`hk agent mcp <--target <TARGET>>`](/cli/agent/mcp.md)
- [`hk builtins`](/cli/builtins.md)
- [`hk cache clear`](/cli/cache/clear.md)
- [`hk check [FLAGS] [FILES]…`](/cli/check.md)
- [`hk completion <SHELL>`](/cli/completion.md)
- [`hk config <SUBCOMMAND>`](/cli/config.md)
- [`hk config dump [--format <FORMAT>]`](/cli/config/dump.md)
- [`hk config explain <KEY>`](/cli/config/explain.md)
- [`hk config get <KEY>`](/cli/config/get.md)
- [`hk config sources`](/cli/config/sources.md)
- [`hk fix [FLAGS] [FILES]…`](/cli/fix.md)
- [`hk init [FLAGS]`](/cli/init.md)
- [`hk install [FLAGS]`](/cli/install.md)
- [`hk mcp [--root <PATH>]`](/cli/mcp.md)
- [`hk migrate <SUBCOMMAND>`](/cli/migrate.md)
- [`hk migrate pre-commit [FLAGS]`](/cli/migrate/pre-commit.md)
- [`hk run [FLAGS] [FILES]… <SUBCOMMAND>`](/cli/run.md)
- [`hk run commit-msg [FLAGS] <COMMIT_MSG_FILE> [FILES]…`](/cli/run/commit-msg.md)
- [`hk run post-checkout [FLAGS] <ARGS>…`](/cli/run/post-checkout.md)
- [`hk run post-commit [FLAGS] [FILES]…`](/cli/run/post-commit.md)
- [`hk run post-merge [FLAGS] <IS_SQUASH> [FILES]…`](/cli/run/post-merge.md)
- [`hk run post-rewrite [FLAGS] <COMMAND> [FILES]…`](/cli/run/post-rewrite.md)
- [`hk run pre-commit [FLAGS] [FILES]…`](/cli/run/pre-commit.md)
- [`hk run pre-push [FLAGS] [ARGS]…`](/cli/run/pre-push.md)
- [`hk run pre-rebase [FLAGS] <ARGS>…`](/cli/run/pre-rebase.md)
- [`hk run prepare-commit-msg [FLAGS] <ARGS>…`](/cli/run/prepare-commit-msg.md)
- [`hk sponsors`](/cli/sponsors.md)
- [`hk test [FLAGS]`](/cli/test.md)
- [`hk uninstall [--global]`](/cli/uninstall.md)
- [`hk util <SUBCOMMAND>`](/cli/util.md)
- [`hk util check-added-large-files [--maxkb <MAXKB>] <FILES>…`](/cli/util/check-added-large-files.md)
- [`hk util check-byte-order-marker [-d --diff] <FILES>…`](/cli/util/check-byte-order-marker.md)
- [`hk util check-case-conflict <FILES>…`](/cli/util/check-case-conflict.md)
- [`hk util check-conventional-commit [--allowed-types… <ALLOWED_TYPES>] <COMMIT_MSG_FILE>`](/cli/util/check-conventional-commit.md)
- [`hk util check-executables-have-shebangs <FILES>…`](/cli/util/check-executables-have-shebangs.md)
- [`hk util check-merge-conflict [--assume-in-merge] <FILES>…`](/cli/util/check-merge-conflict.md)
- [`hk util check-symlinks <FILES>…`](/cli/util/check-symlinks.md)
- [`hk util detect-private-key <FILES>…`](/cli/util/detect-private-key.md)
- [`hk util end-of-file-fixer [-d --diff] [-f --fix] <FILES>…`](/cli/util/end-of-file-fixer.md)
- [`hk util fix-byte-order-marker <FILES>…`](/cli/util/fix-byte-order-marker.md)
- [`hk util fix-smart-quotes [--check] [-d --diff] <FILES>…`](/cli/util/fix-smart-quotes.md)
- [`hk util mixed-line-ending [-d --diff] [-f --fix] <FILES>…`](/cli/util/mixed-line-ending.md)
- [`hk util no-commit-to-branch [--branch… <BRANCH>]`](/cli/util/no-commit-to-branch.md)
- [`hk util python-check-ast <FILES>…`](/cli/util/python-check-ast.md)
- [`hk util python-debug-statements <FILES>…`](/cli/util/python-debug-statements.md)
- [`hk util trailing-whitespace [-d --diff] [-f --fix] <FILES>…`](/cli/util/trailing-whitespace.md)
- [`hk validate`](/cli/validate.md)
- [`hk version`](/cli/version.md)
