# NousResearch/hermes-agent · Slash command naming conflicts and description clarity

## Open now

- 1 issue, 5 PRs open on GitHub.
- #33211: Slash command aliases appear as separate entries in autocomplete list
- PR #33295: fix(cli): filter slash command aliases from autocomplete dropdown (#33211)
- PR #46146: fix: hide noncanonical slash aliases from discovery
- PR #57208: fix: resolve /compact slash command name collision (#57133)
- PR #57519: fix: resolve /compact slash command name collision (#57133)
- PR #66368: fix(slash-commands): add dedup detection in _build_command_lookup (#66327)

Multiple issues and fixes address duplicate alias collisions (especially /compact vs /compress) and confusing or identical descriptions for /new, /reset, and /clear commands. Work spans detection, renaming, deduplication, and documentation improvements across CLI, TUI, and SDK clients.

## TL;DR

- 28 member(s): 1 open issue(s), 10 closed issue(s), 5 open PR(s), 3 merged PR(s), 9 PR(s) closed without merging.
- A fix was merged to main in PR #1237. Verify it addresses your case.
- **Recommended:** read PR #1237 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `partially_resolved` · deciding PR(s): `pr-1237,pr-56235,pr-69303`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.06`: 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

- #33211: Slash command aliases appear as separate entries in autocomplete list

## Closed / duplicate issues

- #641: \[UX\]: /new and /reset commands are confusing — clarify or combine
- #42829: \[Bug\] CLI Commands /new, /start, and /reset Have Identical Descriptions
- #57070: New /compact alias for /compress (#57029) collides with legacy /compact TUI entry in commands.catalog
- #57133: \[Bug\]: /compact slash command name collision causes "Duplicate slash command alias" error
- #57532: commands.catalog returns /compact as both command and alias, causing 'Duplicate slash command alias' error in Desktop/SDK clients
- #64121: CLI duplicate command description for /compress and /compact
- #64122: CLI duplicate command description for /compress and /compact
- #64123: CLI duplicate command description for /compress and /compact
- #64124: CLI duplicate command description for /compress and /compact
- #66327: Duplicate slash commands & cluttered command wiki

## Prior & competing PRs

- **#1237: fix(cli): make /new, /reset, and /clear start real fresh sessions**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `cli.py`, `hermes_cli/commands.py`, `tests/test_cli_new_session.py`
- **#56235: docs: unify /new and /reset rows in gateway slash-commands table**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `website/docs/reference/slash-commands.md`
- **#69303: fix(acp): resolve /compact alias collision across ACP, TUI, and command catalog**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `acp_adapter/server.py`, `apps/desktop/src/lib/desktop-slash-commands.test.ts`, `apps/desktop/src/lib/desktop-slash-commands.ts`, `tests/acp/test_server.py`, `tests/test_tui_gateway_server.py`, `tui_gateway/server.py`, `ui-tui/README.md`, `ui-tui/src/app/slash/commands/core.ts`
- **#749: fix: differentiate /new and /reset commands**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`
- **#899: fix: /new, /reset, and /clear all start a fresh session**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#1237`
- **#33295: fix(cli): filter slash command aliases from autocomplete dropdown (#33211)**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/commands.py`, `tests/hermes_cli/test_commands.py`
- **#42886: docs: fix /new and /reset command descriptions in slash-commands reference**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#56235`, `#56235`, `#42829`
- **#42912: fix(cli): clarify /new, /start, /reset command descriptions**. closed without merge
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#42886`
- **#46146: fix: hide noncanonical slash aliases from discovery**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#33295`, `#33211`, `#33295`
  - files: `hermes_cli/commands.py`, `tests/test_tui_gateway_server.py`, `tui_gateway/server.py`
- **#57073: fix(tui): avoid compact catalog alias collision**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#69303`, `#57162`
- **#57078: fix(tui): let command aliases override TUI extras**. closed without merge
  - maintainer direction: category `stale_abandoned`; implication `active`
- **#57131: fix(tui): resolve /compact alias collision between compress alias and TUI display toggle (#57070)**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#69303`, `#57162`
- **#57162: fix(acp): rename /compact to /compress to avoid Claude Code collision**. closed without merge
  - maintainer direction: category `merged_via`; implication `superseded`; refs `15d33d5ab`, `#69303`
- **#57208: fix: resolve /compact slash command name collision (#57133)**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#57162`, `#57133`, `#57162`
  - files: `acp_adapter/server.py`, `tui_gateway/server.py`, `ui-tui/src/app/slash/commands/core.ts`
- **#57519: fix: resolve /compact slash command name collision (#57133)**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#57162`, `#57162`, `#57208`, `#57162`
  - files: `acp_adapter/server.py`, `tui_gateway/server.py`, `ui-tui/src/app/slash/commands/core.ts`
- **#57691: fix(tui): prune catalog alias collisions with standalone commands**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`
- **#66368: fix(slash-commands): add dedup detection in _build_command_lookup (#66327)**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `hermes_cli/commands.py`

## Fix status

- Merged to main in PR #1237 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-07-22`.
- Subsystem: `acp`