Files

teknium1 d578d06f59 docs: comprehensive accuracy audit fixes (35+ corrections)

CRITICAL fixes:
- Installation: Remove false prerequisites (installer auto-installs everything except git)
- Tools: Remove non-existent 'web_crawl' tool from tools table
- Memory: Remove non-existent 'read' action (only add/replace/remove exist)
- Code execution: Fix 'search' to 'search_files' in sandbox tools list
- CLI commands: Fix --model/--provider/--toolsets/--verbose as chat subcommand flags

IMPORTANT fixes:
- Installation: Add missing installer features (Node.js, ripgrep, ffmpeg, skills seeding)
- Installation: Add 6 missing package extras to table (mcp, honcho, tts-premium, etc)
- Installation: Fix mkdir to include all directories the installer creates
- Quickstart: Add OpenAI Codex to provider table
- CLI: Fix all 'hermes --flag' to 'hermes chat --flag' across all docs
- Configuration: Remove non-existent --max-turns CLI flag
- Tools: Fix 'search' to 'search_files', add missing 'process' tool
- Skills: Remove skills_categories() (not a registered tool)
- Cron: Remove unsupported 'daily at 9am' schedule format
- TTS: Fix output directory to ~/.hermes/audio_cache/
- Delegation: Clarify depth limit wording
- Architecture: Fix default model, chat() signature, file names
- Contributing: Fix Python requirement from 3.11+ to 3.10+
- CLI reference: Add missing commands (login, tools, sessions subcommands)
- Env vars: Fix TERMINAL_DOCKER_IMAGE default, add HERMES_MODEL

2026-03-05 06:50:22 -08:00

6.4 KiB

Raw Blame History

sidebar_position, title, description

sidebar_position	title	description
1	CLI Commands Reference	Comprehensive reference for all hermes CLI commands and slash commands

CLI Commands Reference

Terminal Commands

These are commands you run from your shell.

Core Commands

Command	Description
`hermes`	Start interactive chat (default)
`hermes chat -q "Hello"`	Single query mode (non-interactive)
`hermes chat --continue` / `-c`	Resume the most recent session
`hermes chat --resume <id>` / `-r <id>`	Resume a specific session
`hermes chat --model <name>`	Use a specific model
`hermes chat --provider <name>`	Force a provider (`nous`, `openrouter`)
`hermes chat --toolsets "web,terminal"` / `-t`	Use specific toolsets
`hermes chat --verbose`	Enable verbose/debug output

Provider & Model Management

Command	Description
`hermes model`	Switch provider and model interactively
`hermes login`	OAuth login to a provider (use `--provider` to specify)
`hermes logout`	Clear stored OAuth credentials

Configuration

Command	Description
`hermes setup`	Full setup wizard (provider, terminal, messaging)
`hermes config`	View current configuration
`hermes config edit`	Open config.yaml in your editor
`hermes config set KEY VAL`	Set a specific value
`hermes config check`	Check for missing config (useful after updates)
`hermes config migrate`	Interactively add missing options
`hermes tools`	Interactive tool configuration per platform
`hermes status`	Show configuration status (including auth)
`hermes doctor`	Diagnose issues

Maintenance

Command	Description
`hermes update`	Update to latest version
`hermes uninstall`	Uninstall (can keep configs for later reinstall)
`hermes version`	Show version info

Gateway (Messaging + Cron)

Command	Description
`hermes gateway`	Run gateway in foreground
`hermes gateway setup`	Configure messaging platforms interactively
`hermes gateway install`	Install as system service (Linux/macOS)
`hermes gateway start`	Start the service
`hermes gateway stop`	Stop the service
`hermes gateway restart`	Restart the service
`hermes gateway status`	Check service status
`hermes gateway uninstall`	Uninstall the system service
`hermes whatsapp`	Pair WhatsApp via QR code

Skills

Command	Description
`hermes skills search <query>`	Search skill registries
`hermes skills install <identifier>`	Install a skill (with security scan)
`hermes skills inspect <identifier>`	Preview before installing
`hermes skills list`	List installed skills
`hermes skills list --source hub`	List hub-installed skills only
`hermes skills audit`	Re-scan all hub skills
`hermes skills uninstall <name>`	Remove a hub skill
`hermes skills publish <path> --to github --repo owner/repo`	Publish a skill
`hermes skills snapshot export <file>`	Export skill config
`hermes skills snapshot import <file>`	Import from snapshot
`hermes skills tap add <repo>`	Add a custom source
`hermes skills tap remove <repo>`	Remove a source
`hermes skills tap list`	List custom sources

Cron & Pairing

Command	Description
`hermes cron list`	View scheduled jobs
`hermes cron status`	Check if cron scheduler is running
`hermes cron tick`	Manually trigger a cron tick
`hermes pairing list`	View pending + approved users
`hermes pairing approve <platform> <code>`	Approve a pairing code
`hermes pairing revoke <platform> <user_id>`	Remove user access
`hermes pairing clear-pending`	Clear all pending pairing requests

Sessions

Command	Description
`hermes sessions list`	Browse past sessions
`hermes sessions export <id>`	Export a session
`hermes sessions delete <id>`	Delete a specific session
`hermes sessions prune`	Remove old sessions
`hermes sessions stats`	Show session statistics

Slash Commands (Inside Chat)

Type / in the interactive CLI to see an autocomplete dropdown.

Command	Description
`/help`	Show available commands
`/quit`	Exit the CLI (aliases: `/exit`, `/q`)
`/clear`	Clear screen and reset conversation
`/new`	Start a new conversation
`/reset`	Reset conversation only (keep screen)

Tools & Configuration

Command	Description
`/tools`	List all available tools
`/toolsets`	List available toolsets
`/model [name]`	Show or change the current model
`/config`	Show current configuration
`/prompt [text]`	View/set custom system prompt
`/personality [name]`	Set a predefined personality

Conversation

Command	Description
`/history`	Show conversation history
`/retry`	Retry the last message
`/undo`	Remove the last user/assistant exchange
`/save`	Save the current conversation
`/compress`	Manually compress conversation context
`/usage`	Show token usage for this session

Skills & Scheduling

Command	Description
`/cron`	Manage scheduled tasks
`/skills`	Search, install, inspect, or manage skills
`/platforms`	Show gateway/messaging platform status
`/verbose`	Cycle tool progress: off → new → all → verbose
`/<skill-name>`	Invoke any installed skill

Gateway-Only Commands

These work in messaging platforms (Telegram, Discord, Slack, WhatsApp) but not the interactive CLI:

Command	Description
`/stop`	Stop the running agent (no follow-up message)
`/sethome`	Set this chat as the home channel
`/status`	Show session info
`/reload-mcp`	Reload MCP servers from config
`/update`	Update Hermes Agent to the latest version

Keybindings

Key	Action
`Enter`	Send message
`Alt+Enter` / `Ctrl+J`	New line (multi-line input)
`Ctrl+C`	Interrupt agent (double-press to force exit)
`Ctrl+D`	Exit
`Tab`	Autocomplete slash commands

:::tip Commands are case-insensitive — /HELP works the same as /help. :::

6.4 KiB Raw Blame History