# NousResearch/hermes-agent · Markdown outline mode feature for read_file tool

## Open now

- 1 issue, 2 PRs open on GitHub.
- #103374: \[Feature\]: Optional Markdown outline mode for read_file
- PR #103384: feat(tools): read_file markdown outline mode (#103374)
- PR #103468: feat(files): add bounded Markdown outline navigation

These items relate to adding an optional Markdown outline navigation mode to the read_file tool. The feature appears to support bounded outline-based navigation of Markdown file structure.

## TL;DR

- 3 member(s): 1 open issue(s), 0 closed issue(s), 2 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.67`: 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

- #103374: \[Feature\]: Optional Markdown outline mode for read_file

## Prior & competing PRs

- **#103384: feat(tools): read_file markdown outline mode (#103374)**. open
  - maintainer direction: category `partial_fix`; implication `needs_llm`
  - files: `tests/tools/test_read_file_outline.py`, `tools/file_tools.py`, `tools/markdown_outline.py`
- **#103468: feat(files): add bounded Markdown outline navigation**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `tests/tools/test_file_outline.py`, `tests/tools/test_outline_navigation_contract.py`, `tools/file_operations.py`, `tools/file_outline.py`, `tools/file_tools.py`, `tools/file_tools_read_navigation.py`, `website/docs/reference/tools-reference.md`

## Fix status

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