CLI reference

The bindu binary is the primary interface. All commands accept -h/--help.

Global flags

Flag	Description
`-v, --verbose`	Verbose output (repeat for more: `-vv`, `-vvv`)
`-q, --quiet`	Suppress non-error output
`--json`	Emit structured JSON for machine consumption
`--no-color`	Disable ANSI colors
`--config PATH`	Use a specific config file
`--version`	Print version and exit

`bindu compress`

Compress one or more files.

bindu compress [FLAGS] PATH...

Flag	Description
`-o, --output PATH`	Output path (default: `<input>.bindu`)
`-s, --schema NAME\|PATH`	Schema name or path to `.bindus` file
`-d, --dict PATH`	Shared dictionary (`.bindud`)
`-l, --level N`	1 (fastest) to 9 (best ratio). Default: 6
`-r, --recursive`	Walk directories
`-j, --jobs N`	Parallel workers. Default: CPU count
`--keep`	Keep original file
`--stdout`	Write to stdout
`--no-entropy`	Skip the zstd tail pass (keep file directly legible)
`--max-ratio`	Aggressive tail pass (opaque output)
`--dry-run`	Report expected ratio without writing output
`--partition EXPR`	Split output by field(s)
`--index COLS`	Build Bloom filter index on listed columns
`--seal`	Produce an immutable, Merkle-hashed archive

`bindu decompress`

bindu decompress [FLAGS] PATH...

Flag	Description
`-o, --output PATH`	Output path
`--stdout`	Write to stdout
`--keep`	Keep the `.bindu` file

Aliases: bindu x, bindu decomp.

`bindu view`

Render a Bindu file in a human-readable form without writing a decompressed copy.

bindu view [FLAGS] PATH

Flag	Description
`--path EXPR`	JSONPath-like projection
`--format json\|yaml\|pretty`	Output format (default: pretty)
`--limit N`	Emit at most N records
`--skip N`	Skip the first N records

`bindu query`

Run a selection/projection/aggregation against one or more .bindu files.

bindu query [FLAGS] PATH...

Flag	Description
`--where EXPR`	Filter predicate
`--select COLS`	Columns to project
`--group-by COLS`	Group for aggregation
`--since TS`	Shortcut for `ts >= TS`
`--until TS`	Shortcut for `ts < TS`
`--limit N`	Max rows
`--explain`	Print query plan, don’t execute

Query language is SQL-ish; see Query language.

`bindu schema`

bindu schema generate PATH...      # infer a schema from samples
bindu schema validate FILE.bindus    # check a schema file
bindu schema fingerprint FILE.bindus # print schema fingerprint
bindu schema publish FILE.bindus     # push to a registry
bindu schema pull FINGERPRINT      # fetch from a registry

`bindu dict`

bindu dict build --input GLOB --schema S --out D.bindud
bindu dict inspect D.bindud
bindu dict prune D.bindud --min-freq N

`bindu bench`

bindu bench fetch --out DIR
bindu bench run --corpus DIR --out RESULTS
bindu bench report RESULTS --format markdown

`bindu doctor`

Runs environment checks: version, schema registry reachability, SIMD support, file descriptor limits.

Exit codes

Code	Meaning
0	Success
1	Generic failure
2	Usage error (bad flag, missing arg)
3	Schema error (mismatch, missing, invalid)
4	Integrity error (checksum, Merkle)
5	I/O error
6	Dictionary error
130	Interrupted