Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/techjarves/Hermes-USB-Portable/llms.txt

Use this file to discover all available pages before exploring further.

Hermes provides a broad set of utility commands for diagnostics, data management, plugins, memory, skills, and advanced integrations. These commands are available through the launcher or directly when the portable environment is active.

​
Diagnostics & Maintenance

CommandDescription
hermes doctorRun diagnostics and check for issues
hermes dumpDump debug information
hermes debugDebug mode
hermes logsView agent logs
hermes backupBackup the data directory
hermes checkpointsManage checkpoints
hermes updateUpdate Hermes to the latest version

​
Running Diagnostics

hermes doctor is the first command to run when something isn’t working. It checks the environment, dependencies, and configuration for common problems. 
# Run diagnostics
./launch.sh hermes doctor

# View agent logs
./launch.sh hermes logs

# Back up your data directory
./launch.sh hermes backup

# Update Hermes to the latest version
./launch.sh hermes update
You can also run diagnostics from the interactive launcher menu without typing commands: Advanced Options → [1] Run Doctor.
Log files are stored in data/logs/. The launcher’s Advanced Options → [2] View Logs shows the last 20 lines of gateway.log.

​
Updating Hermes

There are three ways to update Hermes Agent:
  1. CLI: ./launch.sh hermes update
  2. In chat: type /hermes update during an active conversation
  3. Advanced Options → [5] Update Hermes in the launcher menu
For a full clean reinstall, delete .cache/runtimes/<your-platform> and src/hermes-agent, then re-run the launcher to fetch the latest source from scratch.

​
Skills & Memory

CommandDescription
hermes skillsList custom skills
hermes skills createCreate a new skill
hermes skills editEdit an existing skill
hermes memoryMemory management
hermes curatorCurator tools
Skills and persistent memory are stored inside your portable data/ folder, so they travel with your drive and remain available across machines. 
# List all skills
./launch.sh hermes skills

# Create a new skill
./launch.sh hermes skills create

# Edit an existing skill
./launch.sh hermes skills edit

# Open memory management
./launch.sh hermes memory

​
Advanced & Integrations

CommandDescription
hermes modelModel management
hermes fallbackFallback provider settings
hermes proxyProxy settings
hermes lspLSP mode
hermes postinstallRun post-install hooks
hermes whatsappWhatsApp integration tools
hermes slackSlack integration tools
hermes sendSend a message via the configured gateway
hermes pluginsPlugin management
hermes mcpMCP tools
hermes computer-useComputer use tools
hermes cronCron job management
hermes webhookWebhook management
hermes kanbanKanban board
hermes hooksHooks management
hermes importImport data
hermes pairingDevice pairing
hermes insightsAnalytics
hermes clawOpenClaw import
hermes versionVersion information
hermes uninstallUninstall Hermes
hermes acpACP tools
hermes profileProfile management
hermes completionShell completion setup
hermes dashboardDashboard

​
Shell Completion

Set up tab completion for hermes commands in your shell: 
# Set up shell completion
./launch.sh hermes completion

​
Cron Jobs

Use hermes cron to schedule recurring agent tasks. Pair it with hermes gateway and /sethome in Telegram to receive scheduled notifications in your configured home channel. 
# Manage cron jobs
./launch.sh hermes cron

# Manage webhooks
./launch.sh hermes webhook
Run hermes setup gateway before using hermes cron or hermes webhook — the gateway must be configured to deliver scheduled messages and webhook payloads.

​
Authentication

CommandDescription
hermes loginLogin to a service
hermes logoutLogout
hermes authAuthentication management
# Login to a connected service
./launch.sh hermes login

# Manage authentication
./launch.sh hermes auth

# Logout from a service
./launch.sh hermes logout
Authentication tokens and API keys are stored in data/.env inside your portable folder. Back up this file along with data/config.yaml to preserve your credentials when moving the drive.

Build docs developers (and LLMs) love

Get started for freeTalk to us