# NousResearch/hermes-agent · CLI JSON output schema and structured results

## Open now

- 1 issue, 3 PRs open on GitHub.
- #108397: feat(cli): --output-schema for one-shot runs — constrain the final message to a JSON Schema
- PR #108421: feat(cli): --output-schema for one-shot runs — constrain the final message to a JSON Schema
- PR #125355: feat(cli): add JSON results, output schemas and atomic answer files
- PR #130137: feat(cli): hermes -z --output-schema makes one-shot answers schema-shaped JSON (salvage #108421, inspired by Muse Code)

These items relate to adding JSON output support to the CLI, including output schema constraints for one-shot runs and atomic answer files. The work centers on enabling structured, schema-validated JSON responses from CLI commands.

## TL;DR

- 4 member(s): 1 open issue(s), 0 closed issue(s), 3 open PR(s), 0 merged PR(s), 0 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.50`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #108397: feat(cli): --output-schema for one-shot runs — constrain the final message to a JSON Schema

## Prior & competing PRs

- **#108421: feat(cli): --output-schema for one-shot runs — constrain the final message to a JSON Schema**. open
  - maintainer direction: category `merged_via`; implication `superseded`; refs `#130137`, `#130137`
  - files: `hermes_cli/_parser.py`, `hermes_cli/main.py`, `hermes_cli/oneshot.py`, `tests/hermes_cli/test_oneshot_output_schema.py`
- **#125355: feat(cli): add JSON results, output schemas and atomic answer files**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#3`
  - files: `cli.py`, `hermes_cli/_parser.py`, `hermes_cli/cli_single_query.py`, `hermes_cli/main.py`, `hermes_cli/stream_json.py`, `hermes_cli/structured_output.py`, `pyproject.toml`, `tests/hermes_cli/test_structured_output.py`, `tests/hermes_cli/test_structured_output_wire.py`, `website/docs/reference/cli-commands.md`
- **#130137: feat(cli): hermes -z --output-schema makes one-shot answers schema-shaped JSON (salvage #108421, inspired by Muse Code)**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/_parser.py`, `hermes_cli/main.py`, `hermes_cli/oneshot.py`, `tests/hermes_cli/test_oneshot_output_schema.py`, `website/docs/reference/cli-commands.md`

## Fix status

- No merged fix on record.
- Subsystem: `hermes_cli`