Hermes BibleUnofficial Docs
← All docs Docs / Developer Guide

Extending the CLI

Hermes exposes protected extension hooks on so wrapper CLIs can add widgets, keybindings, and layout customizations without overriding the 1000+ line method. Th

Developer Guide
Section
Developer Guide
Source
hermesbible.com/docs/developer-guide/extending-the-cli

Hermes exposes protected extension hooks on so wrapper CLIs can add widgets, keybindings, and layout customizations without overriding the 1000+ line method. Th

Excerpt from the official Hermes Agent documentation, quoted for reference. View source

What this page covers

Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.

Upstream outline

  1. Extension points
  2. Quick start: a wrapper CLI
  3. Hook reference
  4. _get_extra_tui_widgets()
  5. _register_extra_tui_keybindings(kb, *, input_area)
  6. _build_tui_layout_children(**widgets)
  7. Layout diagram
  8. Tips

Section map

Extension points

Maps extension points to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Quick start: a wrapper CLI

Maps quick start: a wrapper cli to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Hook reference

Maps hook reference to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

_get_extra_tui_widgets()

Maps _get_extra_tui_widgets() to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

_register_extra_tui_keybindings(kb, *, input_area)

Maps _register_extra_tui_keybindings(kb, *, input_area) to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

_build_tui_layout_children(**widgets)

Maps _build_tui_layout_children(**widgets) to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Layout diagram

Maps layout diagram to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Tips

Maps tips to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Implementation notes

  • Use this Developer Guide doc as a navigation page first: the local clone mirrors the source structure and links each heading back to the authoritative upstream section.
  • Primary decision areas: Extension points, Quick start: a wrapper CLI, Hook reference, _get_extra_tui_widgets(), _register_extra_tui_keybindings(kb, *, input_area). Read those source anchors before changing installs, credentials, automation, or runtime configuration.
  • Useful search signals for this doc: extending, exposes, protected, extension, hooks. These are derived from the public title and summary so the clone remains lightweight.

Decision table

Best fitDeveloper Guide documentation

Use when you need orientation for extending the cli before applying exact upstream commands.

Verify firstExtension points

Open the source anchor for Extension points and confirm platform-specific requirements before changing configuration.

Escalate to sourceCommands, credentials, runtime behavior

Use the upstream page as the authority for current syntax, release changes, and security-sensitive steps.

Verification checklist

  1. Use this page to orient yourself within Developer Guide, then open the linked source page for exact current syntax.
  2. Start with the source section for Extension points; do not rely on the local summary for commands or secrets.
  3. Check platform, install method, provider, and credential assumptions before changing a real environment.
  4. Review the source section for Quick start: a wrapper CLI if the page involves setup, automation, messaging, or runtime behavior.
  5. After applying anything from the source, run the smallest relevant smoke test before widening scope.

Risk notes

Runtime access

Check filesystem, shell, browser, repository, and server permissions before granting the agent write access.

What this page covers

  • Core concept and where it fits in the Hermes Agent system.
  • Setup or operating context implied by the upstream page summary.
  • The source page link for full current details and updates.

Source mirror note

This page is generated from the public Hermes Bible index so the clone has the same route coverage and search surface. It stores the public title, category, summary, and source link locally; use the source page for full upstream text and updates.

Open source page