Hermes BibleUnofficial Docs
← All docs Docs / Developer Guide

Adding Tools

Before writing a tool, ask yourself: should this be a skill instead? WARNING — Built in Core Tools Only This page is for adding a built in Hermes tool to the re

Developer Guide
Section
Developer Guide
Source
hermesbible.com/docs/developer-guide/adding-tools

Before writing a tool, ask yourself: should this be a skill instead? WARNING — Built in Core Tools Only This page is for adding a built in Hermes tool to the re

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. Overview
  2. Step 1: Create the Built-in Tool File
  3. Key Rules
  4. Step 2: Add the Built-in Tool to a Toolset
  5. ~~Step 3: Add Discovery Import~~ (No longer needed)
  6. Async Handlers
  7. Handlers That Need task_id
  8. Agent-Loop Intercepted Tools
  9. Optional: Setup Wizard Integration
  10. Checklist

Section map

Overview

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

Step 1: Create the Built-in Tool File

Maps step 1: create the built-in tool file to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Key Rules

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

Step 2: Add the Built-in Tool to a Toolset

Maps step 2: add the built-in tool to a toolset to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

~~Step 3: Add Discovery Import~~ (No longer needed)

Maps ~~step 3: add discovery import~~ (no longer needed) to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Async Handlers

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

Handlers That Need task_id

Maps handlers that need task_id to the Developer Guide documentation path, with the source page reserved for exact commands and updates.

Agent-Loop Intercepted Tools

Maps agent-loop intercepted tools 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: Overview, Step 1: Create the Built-in Tool File, Key Rules, Step 2: Add the Built-in Tool to a Toolset, ~~Step 3: Add Discovery Import~~ (No longer needed). Read those source anchors before changing installs, credentials, automation, or runtime configuration.
  • Useful search signals for this doc: adding, tools, before, writing, yourself. 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 adding tools before applying exact upstream commands.

Verify firstOverview

Open the source anchor for Overview 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 Overview; 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 Step 1: Create the Built-in Tool File 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

  • Before writing a tool, ask yourself
  • should this be a skill instead? WARNING
  • Built in Core Tools Only This page is for adding a built in Hermes tool to the re

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