Tools Reference

Execute shell commands, manage background processes, run scripts. The primary way Hermes interacts with your system. Ships two tools (terminal and process) and supports seven backends: local, docker, ssh, modal, daytona, vercel_sandbox, and singularity.

Read, write, search, and patch files on the local filesystem. Replaces cat/grep/sed with agent-friendly structured operations.

Internet search and content extraction. The primary research tool — finds URLs, fetches content, and extracts structured data from web pages.

Browse, install, create, and manage skills. Skills are reusable procedure documents that teach the agent how to do specific tasks.

Persistent cross-session memory. Stores facts about the user, environment, and lessons learned. Pluggable backends (built-in SQLite, Honcho, Mem0).

Search past conversations using FTS5 full-text search. Retrieves summaries of matching sessions. Essential for cross-session context.

Spawn subagents with isolated contexts and terminal sessions. Supports parallel batch execution (up to 10 concurrent children, 250 iterations) with live steering, early stop, and partial-result return.

Built-in scheduler for recurring tasks. Supports durations, cron expressions, and ISO timestamps. Jobs run autonomously with configurable model/skills/delivery.

Ask the user clarifying questions when a task is ambiguous. Supports multiple choice (up to 4 options) and open-ended modes.

In-session task tracking with priority ordering. Supports create, update, mark complete, cancel, and merge operations. One task in_progress at a time.

Sandboxed Python execution with access to file/search/patch/terminal tools. Use for multi-step processing, data filtering, and conditional logic between tool calls.

Full browser automation — navigate pages, click elements, type text, take screenshots, read console output, and execute JavaScript. Supports local Chromium, Browserbase, and Camofox backends.

Image analysis — load and describe images from URLs, file paths, or data URIs. Falls back to an auxiliary vision model if the main model lacks vision capabilities.

AI image generation via multiple backends. Backends include OpenAI (GPT Image 2 / 2.5), xAI Grok-Imagine, FAL, Krea, DeepInfra, OpenRouter + Nous Portal, and Meta AI.

Video analysis and generation. Supports FAL.ai multi-model (Veo 3.1, Kling, Pixverse) and xAI Grok-Imagine backends.

Convert text to spoken audio. STT/TTS providers are local, groq, openai, mistral, xai, elevenlabs, and deepinfra, plus Edge TTS as the free default.

Durable SQLite-based work queue for multi-agent coordination. Tasks have lifecycle (create → assign → complete/block), comments, and links. Dispatcher auto-assigns to worker profiles.

Cross-platform message sending. Routes messages through the gateway to any connected platform — Telegram, Discord, Slack, Signal, and more.

Discord integration tools for the gateway. Enables the Hermes Discord bot to read and respond in channels and DMs.

Discord admin and moderation tools — manage users, roles, channels, and server settings through the agent.

Mixture of Agents is a model-picker provider/preset, not a toolset: configure it with hermes moa configure and pick the preset from the model picker.

Extra introspection and debugging tools. Adds verbose logging, state inspection, and diagnostic capabilities. Off by default.

Minimal, low-risk toolset for locked-down sessions. Strips dangerous tools (terminal, browser, delegation) for safe exploration.

Spotify playback control — play, pause, skip, queue, search, manage playlists and library. Uses Spotify Web API with PKCE OAuth via the Spotify plugin.

Smart home control via Home Assistant integration. Control lights, switches, sensors, and automations through the agent.

Feishu (Lark) document tools — create, read, and edit Feishu documents through the agent.

Feishu (Lark) drive tools — manage files and folders in Feishu Cloud Drive.

Yuanbao (Tencent) integration — @mention users in groups, query member information and group details.

Background desktop control via cua-driver. Takes screenshots and performs click, drag, type, list_apps, and focus_app actions without stealing the cursor or focus. Works with any tool-capable model on macOS, Windows, and Linux; requires cua-driver on PATH.

Read-only public X discovery via the xAI-built-in x_search Responses tool. For authenticated X API reads and account actions use the xurl skill instead.

Create, list, and switch desktop Projects - named multi-folder workspaces. GUI and desktop sessions only.

Twelve desktop-GUI tools for driving the Hermes desktop app: read_terminal, close_terminal, open_preview, close_preview, read_preview, drive_preview, annotate_preview, read_window_below, focus_pane, react_to_message, tour, and tip.

Text-to-video and image-to-video via plugin-registered backends (xAI Grok-Imagine, FAL.ai Veo 3.1 / Pixverse v6 / Kling O3). Pass image_url to animate an image; omit it for text-to-video.

Manage background processes started by the terminal tool - poll, wait, read logs, write to stdin, and kill. Part of the terminal toolset, which ships both terminal and process.