# Binary Analysis CLI Commands

_Last updated: 2026-01-16_

This guide documents the CLI-first binary analysis commands exposed by Stella Ops.

---

## `stella binary fingerprint export`

Export a deterministic binary fingerprint (function hashes, section hashes, symbol table).

### Usage

```bash
stella binary fingerprint export <artifact> \
  --format json \
  --output ./fingerprint.json
```

### Notes
- Supported formats: `json`, `yaml`
- Output is deterministic for identical inputs.
- Use `--output` for offline workflows and evidence bundles.

---

## `stella binary diff`

Compare two binaries and emit a function/symbol-level delta report.

### Usage

```bash
stella binary diff <base> <candidate> \
  --format table \
  --scope function
```

### Notes
- Supported formats: `json`, `table`
- Scopes: `file`, `section`, `function`
- Use `--format json` for automation and CI pipelines.

---

## Output contracts

- All JSON outputs follow the CLI standard envelope (stable ordering, camelCase keys).
- When used in evidence workflows, prefer `--format json` plus `--output` for deterministic artifacts.