d578d06f59
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
185 lines
6.4 KiB
Markdown
185 lines
6.4 KiB
Markdown
---
|
|
sidebar_position: 1
|
|
title: "CLI Commands Reference"
|
|
description: "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.
|
|
|
|
### Navigation & Control
|
|
|
|
| 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`.
|
|
:::
|