CLI fundamentals

Global syntax

fuzit [global-options] <command> [command-options]

Global options:

-V, --version
--json
--quiet
--debug
-h, --help

--json enables machine-readable output.

--quiet suppresses nonessential activity.

--debug enables debug diagnostics.

--quiet and --debug are mutually exclusive.

Unknown commands and invalid arguments return validation-style CLI failures.

Output channels

Fuzit separates:

1. activity/progress; 2. command data; 3. diagnostics.

Human mode can therefore show:

Fuzit v0.0.9 · Scanning repository...

while JSON mode remains machine-readable.

Example:

fuzit --json scan --root . --summary

Typical result shape:

{
  "schemaVersion": 1,
  "root": "/path/to/repository",
  "counts": {
    "files": 37,
    "directories": 26,
    "symlinks": 0
  },
  "status": "complete",
  "nextSteps": [
    "fuzit pack --root .",
    "fuzit graph build --root . --output .fuzit-graph.json"
  ]
}

Counts are repository-specific.

------------------------------------------------------------------------