CLI Reference

Global Options

Option	Description
`--version`	Print the decoct version and exit.
`--help`	Show top-level help and exit.

`decoct compress`

decoct compress [FILES...] [OPTIONS]

Runs the compression pipeline on YAML, JSON, or INI files. Reads from stdin if no files given.

Arguments

Argument	Description
`FILES`	One or more input files or directories. Omit to read from stdin.

Files are auto-detected by extension: .yaml/.yml (YAML), .json (JSON), .ini/.conf/.cfg/.cnf/.properties (INI). Directories are expanded to all matching files.

Options

Option	Description
`--schema TEXT`	Schema file path or bundled name. Auto-detected if omitted.
`--assertions PATH`	Assertions file defining design standards.
`--profile TEXT`	Profile file path or bundled name (`docker-compose`).
`--stats`	Print token statistics to stderr.
`--stats-only`	Print only token statistics (no YAML output).
`--show-removed`	Print per-pass removal details to stderr.
`-o, --output PATH`	Write output to file instead of stdout.
`-r, --recursive`	Recurse into subdirectories when given a directory argument.
`--encoding TEXT`	Tiktoken encoding. Default: `cl100k_base`.

Platform Auto-Detection

When --schema is not provided, decoct examines document structure:

Platform	Detection heuristic
`docker-compose`	Has `services` key with a mapping
`kubernetes`	Has `apiVersion` and `kind` keys
`terraform-state`	Has `terraform_version` and `resources` keys
`cloud-init`	2+ keys from `packages`, `runcmd`, `write_files`, etc.
`ansible-playbook`	List where first item has `hosts` and `tasks`/`roles`
`github-actions`	Has `on` and `jobs` keys
`traefik`	Has `entryPoints` or (`providers` and `api`/`log`)
`prometheus`	Has `scrape_configs` key

Examples

# Basic — auto-detects platform
decoct compress docker-compose.yaml

# Explicit bundled schema
decoct compress config.yaml --schema docker-compose
decoct compress deployment.yaml --schema kubernetes
decoct compress playbook.yaml --schema ansible-playbook
decoct compress cloud-init.yaml --schema cloud-init
decoct compress terraform.tfstate --schema terraform-state
decoct compress prometheus.yml --schema prometheus

# Custom schema file
decoct compress config.yaml --schema schemas/my-platform.yaml

# With schema + assertions
decoct compress config.yaml \
  --schema docker-compose \
  --assertions assertions/docker-services.yaml

# Bundled profile (schema + assertions + pass config)
decoct compress config.yaml --profile docker-compose

# Save with stats
decoct compress config.yaml -o compressed.yaml --stats

# Stats only
decoct compress config.yaml --schema docker-compose --stats-only

# From stdin
kubectl get deployment myapp -o yaml | decoct compress --schema kubernetes

# INI files
decoct compress my.cnf --schema mariadb-mysql --stats

# Multiple files
decoct compress service-a.yaml service-b.yaml

# Directory, recursive, with stats
decoct compress ./config/ --recursive --stats

# Inspect what was removed
decoct compress deployment.yaml --stats-only --show-removed

`decoct schema learn`

decoct schema learn [OPTIONS]

Derives a schema from example configs and/or documentation using an LLM. Requires pip install decoct[llm] and ANTHROPIC_API_KEY.

Options

Option	Description
`-e, --example PATH`	Example config file (repeatable).
`-d, --doc PATH`	Documentation file (repeatable).
`-p, --platform NAME`	Platform name hint.
`-o, --output PATH`	Output file (default: stdout).
`-m, --merge PATH`	Merge into existing schema file.
`--model MODEL_ID`	Anthropic model (default: `claude-sonnet-4-20250514`).

At least one --example or --doc is required.

Examples

decoct schema learn -e docker-compose.yml -p docker-compose -o schema.yaml
decoct schema learn -d haproxy-docs.txt -e haproxy.cfg -p haproxy -o schema.yaml
decoct schema learn -e new-config.yaml -m existing-schema.yaml -o merged.yaml

`decoct assertion learn`

decoct assertion learn [OPTIONS]

Derives assertions from standards documents, examples, or a corpus. Requires pip install decoct[llm] and ANTHROPIC_API_KEY.

Options

Option	Description
`-s, --standard PATH`	Standards document (repeatable).
`-e, --example PATH`	Example config file (repeatable). Mutually exclusive with `--corpus`.
`-c, --corpus PATH`	Config files for cross-file analysis (repeatable). Mutually exclusive with `--example`.
`-p, --platform NAME`	Platform name hint.
`-o, --output PATH`	Output file (default: stdout).
`-m, --merge PATH`	Merge into existing assertions file.
`--model MODEL_ID`	Anthropic model (default: `claude-sonnet-4-20250514`).

At least one of --standard, --example, or --corpus is required.

Examples

decoct assertion learn -s team-standards.md -p docker-compose -o assertions.yaml
decoct assertion learn -c configs/service-a.yml -c configs/service-b.yml -o learned.yaml
decoct assertion learn -s updated-standards.md -m assertions.yaml -o assertions.yaml

Exit Codes

Code	Meaning
`0`	Success.
`1`	Error (missing input, invalid schema, parse error, API error, etc.).

Environment Variables

Variable	Description
`ANTHROPIC_API_KEY`	Required for `schema learn` and `assertion learn`. Not used by `compress`.

stdin / stdout / stderr

Command	stdin	stdout	stderr
`compress`	Input data (when no FILES)	Compressed YAML	Stats, removal details, errors
`schema learn`	—	Generated schema YAML	Progress, errors
`assertion learn`	—	Generated assertions YAML	Progress, errors