hermes-agent / website /docs /reference /cli-symbols.md
SaylorTwift's picture
SaylorTwift HF Staff
Add files using upload-large-folder tool
6aa76ed verified
|
Raw History Blame Contribute Delete
5.98 kB
metadata
title: CLI Symbols Glossary
description: >-
  What every symbol in the Hermes terminal UI means โ€” transcript markers,
  status-bar badges, overlay glyphs, and approval prompts.

CLI Symbols Glossary

The Hermes terminal interfaces speak a compact visual language: dots, chevrons, braille spinners, and status glyphs. This page is the decoder ring. It covers the TUI (where most of these render) and notes the pieces shared with the Classic CLI.

:::note Skins can restyle some of these Glyphs marked themeable below are brand defaults โ€” a skin can override them (for example tool_prefix and the prompt symbol). Everything else is fixed in the renderer. :::

Transcript symbols

What you see in the conversation flow while the agent works.

Symbol Meaning
โฏ Input prompt โ€” where you type. Themeable (skins set their own prompt symbol).
โ— A tool call. The bullet precedes the tool name and its arguments.
โ”Š Tool-activity rail shown with tool lines. Themeable (tool_prefix).
โœ“ / โœ— Tool result: succeeded / failed. Appended to the end of a completed tool line.
โ–ธ / โ–พ Collapsed / expanded section chevron (thinking, tools, subagents, banner sections). Click to toggle.
โ– Streaming cursor โ€” blinks while the model is still emitting text.
โ”‚ โ”œโ”€ โ””โ”€ Tree rails โ€” connect a parent (a delegation, a journey) to its child entries; โ””โ”€ marks the last child.
โ—ˆ Display-only timeline event (session notices rendered inline, not user messages).
โ—‡ An injected reference block, e.g. โ—‡ Reference 1/2 โ€” <label>.
โ†ณ The sticky prompt โ€” echoes the user message the agent is currently working on.
โ˜ / โ˜‘ / โ€ข Markdown task-list items (open / done) and plain list bullets.
โ–ถ Collapsed <details> summary inside rendered markdown.

Status-bar symbols

The single line at the bottom of the TUI. Segments appear only when relevant and drop off first on narrow terminals.

Symbol Meaning
โ ‹โ ™โ นโ€ฆ (braille patterns) Busy spinner. Thinking and tool phases use different braille animation sets.
โ˜ค ๐ŸŒ€ ๐Ÿค” โœจ ๐Ÿต ๐Ÿ”ฎ Frames of the emoji busy-indicator style (/indicator emoji). The default style rotates kaomoji faces instead.
| / - \ Frames of the ascii busy-indicator style.
โฑ Per-prompt elapsed time while the turn runs, e.g. โฑ 12s/3m 45s (turn time / session time).
โฒ The same timer, frozen after the turn completes.
cmp N The session has been auto-compressed N times.
โ–ถ N N /bg tasks currently running.
โš  YOLO YOLO mode is on (auto-approval). Also shown in the startup banner.
โ›“ N N subagents currently active.
โ†ฉ resumes when subagent finishes Reassurance shown while you are idle but delegated work is still in flight โ€” the result returns on its own.
โ— REC Voice mode is recording.
โ—‰ STT Voice recording stopped; speech-to-text is transcribing.
โ—‰ focus Focus view is on (reduced output). Pinned so it never drops off a narrow terminal.
โ™ฅ Affection flash โ€” Hermes noticed you being nice to it.
โšก / ๐Ÿ”‹ Battery indicator (opt-in): plugged in / on battery, with percentage.
N bg N background terminal processes tracked in this session.
N live sessions Open TUI sessions in this process โ€” click to open the session switcher.

Notices

Short-lived status-bar notices carry their own leading glyph, set by severity:

Symbol Meaning
โœ“ Success notice.
โ€ข Informational notice.
โš  Warning (also used for credit warnings).
โœ• Error notice.

Approval and confirmation prompts

Symbol Meaning
โš  approval required A tool wants to run something that needs your explicit yes (bordered panel with the command preview).
โš  / ? Confirmation dialog title: dangerous action / ordinary question.
๐Ÿ” Sudo password prompt (input is masked).
๐Ÿ”‘ Credential/secret input prompt (input is masked).

Subagents overlay (/agents)

Symbol Meaning
โ— Subagent running.
โ—‹ Queued.
โœ“ Completed.
โ–  Interrupted.
โœ— Failed.
โŒ› Timed out.
โš  Errored.
โšกN N currently-active agents in a rollup row.
โ–โ–‚โ–ƒโ–„โ–…โ–†โ–‡โ–ˆ Activity sparkline โ€” recent event volume per branch.

Session switcher (Ctrl+X)

Symbol Meaning
โœ“ Session idle.
โ€ฆ Starting.
? Waiting for input.
โ–ถ Working.
โœŽ draft The composer in that session holds an unsent draft.

Pickers and hubs

Symbol Meaning
โ–ธ Current selection row (model picker and friends).
* The currently-active model / provider.
โ— / โ—‹ Provider authenticated / not authenticated (model picker); plugin state fallback (plugins hub).
โœ“ / โœ— Plugin enabled / disabled (plugins hub).
โ†‘ N more / โ†“ N more More rows above/below the visible window of a list.
โ”ƒ Scrollbar thumb on scrollable overlays.

Goals

Goal lifecycle notices (from goals) lead with their state:

Symbol Meaning
โœ“ Goal complete.
โ†ป Goal continuing โ€” another iteration was scheduled.
โธ Goal paused.

See also

  • TUI โ€” status line, details modes, busy-indicator styles
  • Classic CLI โ€” shared keybindings and slash commands
  • Skins & Themes โ€” which glyphs and colors you can customize