PR #12362: feat: support copy command

• Repository: NousResearch/hermes-agent
• Author: gyliu513
• State: open | merged: False
• Link: https://github.com/NousResearch/hermes-agent/pull/12362

Description (problem / solution / changelog)

What does this PR do?

Add /copy support

Related Issue

Fixes #11835

Type of Change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 🔒 Security fix
• 📝 Documentation update
• ✅ Tests (adding or improving test coverage)
• ♻️ Refactor (no behavior change)
• 🎯 New skill (bundled or hub)

Changes Made

Here are all the changes made for this feature:

Python — Classic CLI

cli.py

• Added _CODE_BLOCK_RE regex and _extract_code_blocks() helper (line ~119) to parse fenced code blocks from markdown text
• Modified _write_osc52_clipboard() to try native clipboard (pbcopy/xclip/xsel) first, falling back to OSC 52 only over SSH
• Added _copy_to_system_clipboard() method — runs pbcopy on macOS, wl-copy/xclip/xsel on Linux via subprocess
• Rewrote _handle_copy_command() — detects code blocks and delegates to the interactive picker when present
• Added _copy_with_picker() — builds picker labels from code blocks and calls curses_copy_picker
• Added _copy_text_to_clipboard() — extracted clipboard copy + confirmation message
• Added _write_copy_to_file() — prompts for file path (with smart extension default) and writes selected content

hermes_cli/curses_ui.py

• Added curses_copy_picker() — curses-based single-select with Enter (copy) / w (write to file) / Esc (cancel)
• Added _copy_picker_numbered_fallback() — text-based fallback for non-curses terminals

hermes_cli/commands.py

• Updated CommandDef description for /copy to mention the interactive picker

TypeScript — TUI (Ink)

ui-tui/src/app/interfaces.ts

• Added CopyPickerState and CopyPickerItem interfaces
• Added copyPicker: CopyPickerState | null to OverlayState

ui-tui/src/app/overlayStore.ts

• Added copyPicker: null to default overlay state
• Included copyPicker in the $isBlocked computed store

ui-tui/src/app/useInputHandlers.ts

• Added keyboard handling for the copy picker overlay (up/down/Enter/w/Esc)

ui-tui/src/components/appOverlays.tsx

• Added copy picker rendering inside FloatingOverlays with cursor highlight
• Updated hasAny guard to include copyPicker

ui-tui/src/app/slash/commands/core.ts

• Enhanced /copy run handler to extract code blocks and open the picker overlay when blocks are present

ui-tui/src/lib/text.ts

• Added CodeBlock interface and extractCodeBlocks() function

Tests

tests/cli/test_cli_copy_command.py

• Updated existing tests to use _copy_to_system_clipboard mock instead of _write_osc52_clipboard
• Added test_copy_falls_back_to_osc52_when_native_unavailable
• Added test_extract_code_blocks_finds_fenced_blocks, test_extract_code_blocks_no_lang_defaults_to_text, test_extract_code_blocks_returns_empty_for_no_blocks
• Added test_copy_opens_picker_when_code_blocks_present, test_copy_no_picker_when_no_code_blocks
• Added test_copy_with_picker_copies_full_response, test_copy_with_picker_copies_specific_block, test_copy_with_picker_cancel, test_copy_with_picker_write_to_file
• Added test_curses_copy_picker_fallback_non_tty
• Added test_system_clipboard_uses_pbcopy_on_macos, test_system_clipboard_skipped_over_ssh

How to Test

● how are you
────────────────────────────────────────


╭─ ⚕ Hermes ───────────────────────────────────────────────────────────────────────────────────────────────╮
    I’m running smoothly—just a bunch of code eager to help you. How can I assist you now?
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────╯

⚙️  /copy
  Copied assistant response #5 to clipboard
 ⚕ gpt-oss:20b │ 15.9K/131.1K │ [█░░░░░░░░░] 12% │ 7m

Checklist

Code

• I've read the Contributing Guide
• My commit messages follow Conventional Commits (fix(scope):, feat(scope):, etc.)
• I searched for existing PRs to make sure this isn't a duplicate
• My PR contains only changes related to this fix/feature (no unrelated commits)
• I've run pytest tests/ -q and all tests pass
• I've added tests for my changes (required for bug fixes, strongly encouraged for features)
• I've tested on my platform: <!-- e.g. Ubuntu 24.04, macOS 15.2, Windows 11 -->

Documentation & Housekeeping

• I've updated relevant documentation (README, docs/, docstrings) — or N/A
• I've updated cli-config.yaml.example if I added/changed config keys — or N/A
• I've updated CONTRIBUTING.md or AGENTS.md if I changed architecture or workflows — or N/A
• I've considered cross-platform impact (Windows, macOS) per the compatibility guide — or N/A
• I've updated tool descriptions/schemas if I changed tool behavior — or N/A

For New Skills

• This skill is broadly useful to most users (if bundled) — see Contributing Guide
• SKILL.md follows the standard format (frontmatter, trigger conditions, steps, pitfalls)
• No external dependencies that aren't already available (prefer stdlib, curl, existing Hermes tools)
• I've tested the skill end-to-end: hermes --toolsets skills -q "Use the X skill to do Y"

Screenshots / Logs

Changed files

• cli.py (modified, +146/-4)
• hermes_cli/commands.py (modified, +1/-1)
• hermes_cli/curses_ui.py (modified, +130/-0)
• tests/cli/test_cli_copy_command.py (modified, +196/-6)
• ui-tui/src/app/interfaces.ts (modified, +11/-0)
• ui-tui/src/app/overlayStore.ts (modified, +3/-2)
• ui-tui/src/app/slash/commands/core.ts (modified, +22/-1)
• ui-tui/src/app/useInputHandlers.ts (modified, +25/-0)
• ui-tui/src/components/appOverlays.tsx (modified, +26/-1)
• ui-tui/src/lib/text.ts (modified, +17/-0)