# NousResearch/hermes-agent · Linux/Ubuntu API key input issues during setup

## Open now

- Nothing open on GitHub.

Multiple bug reports and fix attempts address terminal freezing or inability to paste API keys during CLI setup on Linux and WSL, likely related to bracketed paste marker handling. One member about a Telegram bot token setup appears loosely related or incidental.

## TL;DR

- 8 member(s): 0 open issue(s), 4 closed issue(s), 0 open PR(s), 1 merged PR(s), 3 PR(s) closed without merging.
- A fix was merged to main in PR #20219. Verify it addresses your case.
- **Recommended:** read PR #20219 (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-20219`. 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.18`: 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.

## Closed / duplicate issues

- #13033: \[Bug\]: hermes setup freezes terminal when pasting API keys on Linux
- #15768: \[Bug\]: Unable to Enter or Paste API Key During Hermes Setup on Ubuntu - CRITICAL
- #16491: \[Setup\]: can't paste api key critical on Linux human need !! stop bot for critical issue
- #31054: \[Setup\]: Telegram bot token

## Prior & competing PRs

- **#13046: fix: terminal freeze when pasting API keys in hermes setup on Linux**. closed without merge · fix tier `suggested`
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - _suggested-tier fix detail withheld; re-request with `?tier=all` to include it._
- **#16270: fix(setup): API key prompt accepts input on Ubuntu after curses**. closed without merge · fix tier `suggested`
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`
- **#20219: fix(cli): sanitize bracketed paste markers during setup (salvage #16784)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `hermes_cli/setup.py`, `scripts/release.py`, `tests/hermes_cli/test_setup_prompt_menus.py`
- **#16784: fix(cli): sanitize bracketed paste markers during setup**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`

## Fix status

- Merged to main in PR #20219 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-05-05`.
- Subsystem: `hermes_cli`