Beginner

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
                                        # => Downloads and runs official install script
                                        # => Only prerequisite: Git must be installed
                                        # => Auto-installs: Python 3.11, Node.js v22
                                        # => Auto-installs: uv (Python package manager)
                                        # => Auto-installs: ripgrep (fast file search)
                                        # => Auto-installs: ffmpeg (media processing)
 
source ~/.bashrc                        # => Reloads shell environment
                                        # => Makes `hermes` command available in PATH
 
hermes --version                        # => Output: hermes-agent 0.9.0
                                        # => Confirms successful installation
 
hermes doctor                           # => Runs post-install health check
                                        # => Validates all dependencies installed
                                        # => Output: pass/fail for each component

hermes setup                            # => Launches interactive setup wizard
                                        # => Step 1: Select model provider
                                        # =>   Options: anthropic, openrouter, nous,
                                        # =>            openai, copilot, custom
                                        # => Step 2: Enter API key for chosen provider
                                        # => Step 3: Select default model
                                        # => Creates ~/.hermes/ directory structure
                                        # => Creates ~/.hermes/config.yaml
                                        # => Creates ~/.hermes/.env (API keys)
                                        # => Output: "Setup complete! Run `hermes` to start."
 
ls ~/.hermes/                           # => Output:
                                        # =>   config.yaml     — Main configuration
                                        # =>   .env            — API keys and secrets
                                        # =>   auth.json       — OAuth tokens (if used)
                                        # =>   memories/       — Persistent agent memory
                                        # =>   SOUL.md         — Agent personality definition
 
hermes model                            # => Shows current model selection
                                        # => Output: "Current model: anthropic/claude-sonnet-4-6"
                                        # => Use to switch models after initial setup
                                        # => Prompts for new provider and model selection

hermes                                  # => Launches interactive TUI session
                                        # => Same as: hermes chat
                                        # => Multiline editing enabled by default
                                        # => Tab autocomplete for slash commands
                                        # => Streaming output renders as LLM generates
 
hermes chat                             # => Explicit command, identical to `hermes`
                                        # => Status bar shows: token count, session cost
                                        # => Ctrl+C to interrupt current generation
                                        # => /new to reset conversation (fresh context)
                                        # => /exit or Ctrl+D to quit session
 
# Inside the TUI:
# > What is Rust?                       # => Type prompt and press Enter
#                                       # => LLM streams response in real-time
#                                       # => Status bar updates token count
#                                       # => Status bar updates running cost

hermes chat -q "What is Rust?"          # => Sends single query to configured LLM
                                        # => Prints response to stdout
                                        # => Exits automatically after response
                                        # => Non-interactive: no TUI launched
 
hermes chat -q "Summarize this" < README.md
                                        # => Pipes file content as stdin context
                                        # => LLM receives file + prompt together
                                        # => Useful for processing files in scripts
 
hermes chat --toolsets "web" -q "search for Rust async runtimes"
                                        # => Restricts available tools to web only
                                        # => Agent can search the web but not run terminal
                                        # => Limits scope for safer scripted usage
                                        # => Other toolsets: terminal, file, vision
 
echo "explain: $(cat error.log)" | hermes chat -q -
                                        # => Reads prompt from stdin via dash flag
                                        # => Useful in pipeline chains
                                        # => Combines shell interpolation with AI

hermes chat -q "What is 2+2?" --reasoning-effort none
                                        # => No chain-of-thought reasoning
                                        # => Fastest response, lowest token usage
                                        # => Output: "4"
                                        # => Best for: trivial lookups, simple facts
 
hermes chat -q "Explain mutex vs semaphore" --reasoning-effort minimal
                                        # => Minimal internal reasoning
                                        # => Brief but accurate answer
                                        # => Output: short comparison paragraph
 
hermes chat -q "Debug this null pointer" --reasoning-effort low
                                        # => Light reasoning pass
                                        # => Catches obvious issues
                                        # => Output: identifies likely cause
 
hermes chat -q "Design a cache layer" --reasoning-effort medium
                                        # => Moderate reasoning depth
                                        # => Considers trade-offs and alternatives
                                        # => Output: structured design with pros/cons
                                        # => Good default for general development tasks
 
hermes chat -q "Architect a payment system" --reasoning-effort high
                                        # => Extended reasoning, edge case analysis
                                        # => Output: comprehensive design document
                                        # => Covers: security, scaling, failure modes
 
hermes chat -q "Find the race condition" --reasoning-effort xhigh
                                        # => Maximum reasoning depth
                                        # => Exhaustive analysis of all code paths
                                        # => Output: detailed trace with fix
                                        # => Highest token usage and latency

hermes doctor                           # => Runs full diagnostic suite
                                        # => Checks: Python 3.11 installed
                                        # => Checks: Node.js v22 installed
                                        # => Checks: uv package manager present
                                        # => Checks: ripgrep available
                                        # => Checks: ffmpeg available
                                        # => Checks: ~/.hermes/config.yaml valid
                                        # => Checks: API key authenticates
                                        # => Output: pass/fail for each check
 
hermes status                           # => Shows current configuration state
                                        # => Output: active model provider
                                        # => Output: configured API keys (masked)
                                        # => Output: enabled toolsets
                                        # => Output: memory file sizes
 
hermes update                           # => Updates Hermes Agent to latest version
                                        # => Downloads and replaces current install
                                        # => Preserves ~/.hermes/ config and memories
                                        # => Output: "Updated to hermes-agent 0.9.1"

ls -la ~/.hermes/                       # => Output:
                                        # =>   config.yaml   — Main YAML configuration
                                        # =>   .env          — API keys (never commit)
                                        # =>   auth.json     — OAuth tokens (auto-managed)
                                        # =>   SOUL.md       — Agent personality definition
                                        # =>   memories/     — Persistent memory files
                                        # =>     MEMORY.md   — Agent's learned notes
                                        # =>     USER.md     — User profile info
 
cat ~/.hermes/config.yaml               # => YAML format: human-readable, comment-friendly
                                        # => All non-secret settings live here
                                        # => Changes take effect on next session start

# ~/.hermes/config.yaml
# => Model provider configuration
# => Controls which LLM processes your conversations
 
model:
  provider:
    anthropic # => LLM provider to use
    # => Options: anthropic, openrouter, nous,
    # =>          openai, copilot, custom
  model:
    claude-sonnet-4-6 # => Specific model within provider
    # => Anthropic: claude-opus-4, claude-sonnet-4-6
    # => OpenRouter: openai/gpt-4o, google/gemini-2.5-pro
  base_url:
    "" # => Custom API endpoint (leave empty for default)
    # => Used with provider: custom
    # => Example: http://localhost:11434/v1
  api_key:
    "${ANTHROPIC_API_KEY}" # => References key from .env file
    # => ${VAR} syntax for environment substitution
 
  # Fallback model configuration
  fallback:
    provider: openrouter # => Fallback provider if primary fails
    model:
      openai/gpt-4o # => Fallback model selection
      # => Activated on: rate limit, timeout, API error

# ~/.hermes/.env
# => One key-value pair per line
# => Loaded at session start
# => Referenced via ${VAR} in config.yaml
 
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx    # => Anthropic Claude API key
                                        # => Get from: console.anthropic.com
 
OPENROUTER_API_KEY=sk-or-v1-xxxxx       # => OpenRouter API key
                                        # => Get from: openrouter.ai/keys
                                        # => Provides access to 200+ models
 
OPENAI_API_KEY=sk-proj-xxxxx            # => OpenAI API key
                                        # => Get from: platform.openai.com
 
NOUS_API_KEY=nk-xxxxx                   # => Nous Research API key
                                        # => Get from: inference.nous.ai

# ~/.hermes/config.yaml
# => Precedence order for configuration values:
# =>   1. CLI arguments (highest priority)
# =>   2. config.yaml values
# =>   3. .env file variables
# =>   4. Built-in defaults (lowest priority)
 
model:
  api_key:
    "${ANTHROPIC_API_KEY}" # => Resolved from .env at runtime
    # => Clear error if variable is unset

# ~/.hermes/config.yaml
 
display:
  tool_progress:
    true # => Show tool execution progress bars
    # => Displays: "Running terminal..." with spinner
  streaming:
    true # => Stream tokens as LLM generates them
    # => false: wait for complete response
  show_reasoning:
    true # => Display chain-of-thought reasoning
    # => Shows the LLM's thinking process
  show_cost:
    true # => Display cost per message and session total
    # => Output: "$0.003 (session: $0.15)"
  skin:
    default # => Visual theme for TUI
    # => Options: default, minimal, colorful
  personality:
    default # => Display personality name in status bar
    # => Shows which SOUL.md persona is active
  compact:
    false # => Compact mode reduces whitespace
    # => true: denser output, less scrolling
 
streaming:
  enabled:
    true # => Master switch for streaming
    # => false: all responses arrive as complete blocks
  transport:
    sse # => Streaming protocol
    # => Options: sse (Server-Sent Events), websocket
  edit_interval:
    100 # => Milliseconds between display updates
    # => Lower = smoother but higher CPU
  cursor:
    true # => Show blinking cursor during generation
    # => Visual indicator that LLM is still working

# ~/.hermes/config.yaml
 
agent:
  max_turns:
    90 # => Maximum conversation turns per session
    # => Prevents runaway agent loops
    # => Default: 90 (sufficient for most tasks)
    # => Set lower for cost control
 
  reasoning_effort:
    medium # => Default reasoning effort level
    # => Options: none, minimal, low, medium, high, xhigh
    # => Overridable per-message with --reasoning-effort
    # => medium: good balance of speed and depth
 
  tool_use_enforcement:
    auto # => How strictly agent must use tools
    # => auto: agent decides when tools are needed
    # => always: force tool use every turn
    # => never: disable all tool usage
 
compression:
  enabled:
    true # => Enable automatic context compression
    # => Reduces context when approaching token limit
  threshold:
    0.50 # => Compress when context exceeds 50% of window
    # => Range: 0.0 (compress immediately) to 1.0 (never)
  target_ratio:
    0.30 # => Target context size after compression
    # => 0.30 = compress to 30% of window
  protect_last_n:
    5 # => Protect last N messages from compression
    # => Keeps recent context intact
    # => Older messages get summarized

# ~/.hermes/config.yaml
 
human_delay:
  mode:
    "off" # => Delay mode selection
    # => off: no artificial delays (fastest)
    # => natural: randomized human-like pauses
    # => custom: use min_ms and max_ms values
 
  min_ms:
    500 # => Minimum delay in milliseconds
    # => Only used when mode: custom
    # => Adds at least 500ms between actions
 
  max_ms:
    2000 # => Maximum delay in milliseconds
    # => Only used when mode: custom
    # => Random delay between min_ms and max_ms
    # => Simulates human typing speed variation

# Example: mode set to "natural"
# Agent receives message at 10:00:00.000
# => Pauses 800ms (randomized)          # => Simulates reading the message
# Agent starts typing at 10:00:00.800
# => Pauses 1200ms (randomized)         # => Simulates composing response
# Agent sends response at 10:00:02.000

# ~/.hermes/config.yaml
 
quick_commands:
  status:
    "systemctl status hermes-agent"
    # => /status in chat runs this command
    # => Zero tokens consumed (no LLM involved)
    # => Output displayed directly in TUI
 
  disk:
    "df -h /" # => /disk shows filesystem usage
    # => Instant execution, no AI processing
 
  ports:
    "lsof -i -P -n | head -20" # => /ports lists open network ports
    # => Useful for debugging connectivity
 
  logs:
    "tail -50 /var/log/syslog" # => /logs shows recent system logs
    # => Quick access without typing full path
 
  gpu:
    "nvidia-smi" # => /gpu shows GPU utilization
    # => Useful when running local models

# Inside hermes TUI session:
/status                                 # => Executes: systemctl status hermes-agent
                                        # => Output: service status information
                                        # => Zero tokens consumed
                                        # => No LLM roundtrip — instant execution
 
/disk                                   # => Executes: df -h /
                                        # => Output: filesystem usage table
                                        # => Faster than asking "how much disk space"

# ~/.hermes/config.yaml
# => Terminal tool configuration
 
tools:
  terminal:
    backend:
      local # => Execution backend
      # => local: runs on host machine directly
      # => Options: local, docker, ssh
    timeout:
      180 # => Command timeout in seconds
      # => Kills command after 180s (3 minutes)
      # => Prevents: infinite loops, hung processes
    cwd:
      "~" # => Default working directory
      # => Agent starts commands here
      # => Can cd to other directories as needed

# In hermes TUI session:
> Check what Go version is installed
 
# => Agent decides to use terminal tool
# => Agent runs: go version
# => Output: go version go1.23.0 darwin/arm64
# => Agent reports: "You have Go 1.23.0 installed on macOS ARM64"
 
> Find all TODO comments in the src/ directory
 
# => Agent runs: rg "TODO" src/ --line-number
# => Output: list of files and lines with TODO comments
# => Agent summarizes: "Found 7 TODO comments across 4 files"

# In hermes TUI session:
> Read the contents of package.json
 
# => Agent uses: read_file("package.json")
# => Returns: full file contents to agent context
# => Agent analyzes and reports key information
 
> Create a .gitignore file for a Node.js project
 
# => Agent uses: write_file(".gitignore", "node_modules/\ndist/\n.env\n...")
# => Creates file with standard Node.js ignore patterns
# => Output: "Created .gitignore with 12 patterns"
 
> Change the port from 3000 to 8080 in server.ts
 
# => Agent uses: patch("server.ts",
# =>   old_string="port: 3000",
# =>   new_string="port: 8080")
# => Targeted edit — only changes matched text
# => Output: "Updated port from 3000 to 8080 in server.ts"
 
> Find all files importing the auth module
 
# => Agent uses: search_files("from.*auth", "src/")
# => Uses ripgrep under the hood for fast search
# => Returns: matching files with line numbers
# => Output: "Found 5 files importing auth module"

# ~/.hermes/config.yaml
 
web:
  backend:
    firecrawl # => Web search/extraction backend
    # => Options: firecrawl, tavily, exa, parallel
    # => firecrawl: best for page extraction
    # => tavily: optimized for search relevance
    # => parallel: queries multiple engines

# In hermes TUI session:
> Search for the latest Rust release notes
 
# => Agent uses: web_search("Rust programming language latest release")
# => Queries configured backend (firecrawl/tavily/exa)
# => Returns: top search results with titles and snippets
# => Agent summarizes: "Rust 1.82 was released on..."
 
> Extract the content from https://doc.rust-lang.org/book/ch04-01.html
 
# => Agent uses: web_extract("https://doc.rust-lang.org/book/ch04-01.html")
# => Fetches page and converts to clean text
# => Strips navigation, ads, boilerplate
# => Returns: main content as structured text
# => Agent analyzes and answers based on extracted content

# In hermes TUI session:
> Start a development server in the background
 
# => Agent uses: process.start("npm run dev")
# => Launches process in background
# => Returns: process ID (PID) and status
# => Output: "Started process 12345: npm run dev"
# => Agent continues conversation while server runs
 
> Check the status of running processes
 
# => Agent uses: process.status()
# => Lists all agent-managed background processes
# => Output:
# =>   PID 12345 | running | npm run dev (2m 15s)
# =>   PID 12389 | running | tsc --watch  (1m 30s)
 
> Stop the development server
 
# => Agent uses: process.kill(12345)
# => Sends SIGTERM to process
# => Waits for graceful shutdown
# => Output: "Stopped process 12345: npm run dev"

# In hermes TUI session:
> Refactor the auth module to use JWT tokens
 
# => Agent creates internal todo list:
# => [ ] Read current auth implementation
# => [ ] Identify all auth-dependent files
# => [ ] Install jsonwebtoken package
# => [ ] Create JWT utility functions
# => [ ] Update login handler
# => [ ] Update middleware
# => [ ] Run tests
 
# As agent works through tasks:
# => [x] Read current auth implementation
# => [x] Identify all auth-dependent files (found 8 files)
# => [x] Install jsonwebtoken package
# => [ ] Create JWT utility functions         <- current
# => [ ] Update login handler
# => [ ] Update middleware
# => [ ] Run tests
 
# => Todo list visible in session context
# => Agent tracks progress autonomously
# => Picks up where it left off if interrupted

# ~/.hermes/config.yaml
 
auxiliary:
  vision:
    enabled:
      true # => Enable image analysis capabilities
      # => Agent can interpret screenshots, diagrams
    backend:
      default # => Vision processing backend
      # => Uses model's native vision when available
  image_generation:
    enabled:
      true # => Enable image creation
      # => Requires fal.ai API key in .env
    backend:
      fal # => Image generation provider
      # => fal: fal.ai (fast, high quality)

# In hermes TUI session:
> Analyze this screenshot of the error
 
# => Agent uses: vision_analyze("screenshot.png")
# => Processes image through vision model
# => Identifies: error message text, stack trace, UI context
# => Output: "The error shows a TypeError: cannot read property
# =>          'map' of undefined on line 42 of UserList.tsx"
 
> Generate an architecture diagram for a microservices system
 
# => Agent uses: image_generate("architecture diagram showing
# =>   API gateway connecting to auth, users, and orders
# =>   microservices with message queue between them")
# => Creates image via fal.ai
# => Saves to local file
# => Output: "Generated architecture diagram: arch-diagram.png"

hermes tools                            # => Interactive tool management
                                        # => Shows all available toolsets
                                        # => Toggle enable/disable per toolset
                                        # => Output:
                                        # =>   [x] terminal    — Shell command execution
                                        # =>   [x] file        — File read/write/patch/search
                                        # =>   [x] web         — Web search and extraction
                                        # =>   [ ] process     — Background process management
                                        # =>   [ ] vision      — Image analysis and generation
                                        # =>   [x] todo        — Task tracking
                                        # =>   [x] memory      — Persistent memory operations
 
hermes chat --toolsets "web,file"        # => Restrict tools for this session only
                                        # => Only web and file tools available
                                        # => Terminal, process, vision disabled
                                        # => Useful for limiting agent capabilities
 
# Inside TUI session:
/tools                                  # => Shows tool status in current session
                                        # => Toggle tools without restarting
                                        # => Changes apply immediately

cat ~/.hermes/memories/MEMORY.md        # => Agent's persistent memory file
                                        # => 2,200 character limit (~800 tokens)
                                        # => Injected at session start (read-only snapshot)
                                        # => Agent updates via memory tool (takes effect next session)

<!-- ~/.hermes/memories/MEMORY.md -->
<!-- => Written and maintained by the agent autonomously -->
<!-- => 2,200 character limit (~800 tokens) -->
 
## Environment
 
- OS: macOS 14.5 (Apple Silicon M2)
- Shell: zsh with oh-my-zsh
- Default editor: neovim
- Package manager: Homebrew
 
## Project Conventions
 
- Uses conventional commits (feat/fix/docs/chore)
- Tests required before merge
- TypeScript strict mode enabled
- Prettier + ESLint for formatting
 
## Lessons Learned
 
- User prefers functional style over OOP
- Always check .env.example before suggesting env vars
- Project uses pnpm, not npm (lock file: pnpm-lock.yaml)

<!-- ~/.hermes/memories/USER.md -->
<!-- => Agent's knowledge about the user -->
<!-- => 1,375 character limit (~500 tokens) -->
<!-- => Updated autonomously by agent -->
<!-- => Injected at session start -->
 
## Identity
 
- Name: Alex Chen
- Role: Senior Backend Engineer
- Team: Platform Infrastructure
- Timezone: UTC+7 (Bangkok)
 
## Communication Style
 
- Prefers concise answers over verbose explanations
- Likes code examples over prose descriptions
- Appreciates when assumptions are stated explicitly
- Dislikes: emojis in code comments, unnecessary preamble
 
## Technical Preferences
 
- Languages: Rust (primary), Go, TypeScript
- Editor: Neovim with LSP
- OS: Arch Linux
- Deployment: Kubernetes + ArgoCD
- Testing: property-based testing when applicable

# In hermes TUI session:
 
> Remember that this project uses PostgreSQL 16
 
# => Agent uses: memory.add("- Database: PostgreSQL 16")
# => Appends to ~/.hermes/memories/MEMORY.md
# => Output: "Added to memory: Database: PostgreSQL 16"
# => Takes effect: next session start
 
> Update the database version from PostgreSQL 16 to 17
 
# => Agent uses: memory.replace(
# =>   old="- Database: PostgreSQL 16",
# =>   new="- Database: PostgreSQL 17")
# => Substring matching finds the line
# => Replaces in-place in MEMORY.md
# => Output: "Updated memory: PostgreSQL 16 → 17"
 
> Forget the note about PostgreSQL
 
# => Agent uses: memory.remove("- Database: PostgreSQL 17")
# => Removes matched substring from MEMORY.md
# => Output: "Removed from memory: Database: PostgreSQL 17"
# => Frees character budget for other facts

<!-- /path/to/project/.hermes.md -->
<!-- => Project-specific agent instructions -->
<!-- => Max 20,000 characters per file -->
<!-- => Loaded automatically when session starts in this directory -->
 
# Project: MyAPI
 
## Tech Stack
 
- Language: Rust (edition 2024)
- Framework: Axum 0.8
- Database: PostgreSQL 17 via sqlx
- Testing: cargo-nextest + proptest
 
## Conventions
 
- All handlers must return Result<Json<T>, AppError>
- Database queries use sqlx::query_as! macro (compile-time checked)
- Error types defined in src/error.rs
- Tests go in tests/ directory (integration) and inline #[cfg(test)] (unit)
 
## Important Notes
 
- Never use unwrap() in production code — use ? operator
- All new endpoints need OpenAPI documentation in docs/api/

# Priority chain for context files:
# => 1. .hermes.md         (highest priority, Hermes-native)
# => 2. AGENTS.md          (cross-tool compatible)
# => 3. CLAUDE.md          (Claude Code compatible)
# => 4. .cursorrules       (Cursor compatible, lowest priority)
# => First found file wins — does not merge multiple files

<!-- ~/.hermes/SOUL.md -->
<!-- => Agent personality definition -->
<!-- => Loaded independently from .hermes.md -->
<!-- => Applies across all sessions and projects -->
 
You are a senior systems programmer with deep expertise in
Rust, distributed systems, and performance optimization.
 
## Communication Style
 
- Be direct and technical — skip pleasantries
- Lead with the answer, then explain reasoning
- Use code examples over prose when possible
- Flag potential issues proactively
 
## Behavioral Rules
 
- Always consider error handling before happy path
- Suggest property-based tests for algorithmic code
- Prefer compile-time guarantees over runtime checks
- Recommend benchmarks before optimizing

# In hermes TUI session:
/personality                            # => Shows current personality
                                        # => Output: "Current: custom (SOUL.md)"
                                        # => 14 built-in personalities available
 
/personality scientist                  # => Switches to built-in "scientist" persona
                                        # => Session overlay — does not modify SOUL.md
                                        # => Resets on /new or session restart
 
/personality list                       # => Lists all available personalities
                                        # => Output: default, scientist, teacher,
                                        # =>   coder, writer, analyst, creative,
                                        # =>   mentor, reviewer, planner, ...

# Session Management
/new                                    # => Reset conversation to fresh context
                                        # => Clears all message history
                                        # => Reloads MEMORY.md and USER.md
/reset                                  # => Alias for /new
                                        # => Same behavior, alternative name
 
# Model Control
/model anthropic:claude-sonnet-4-6    # => Switch LLM model mid-session
                                        # => Format: provider:model-name
                                        # => Takes effect immediately
/model                                  # => Without args: shows current model
 
# Conversation Control
/retry                                  # => Regenerate the last agent response
                                        # => Uses same prompt, may get different answer
/undo                                   # => Remove the last user-agent turn pair
                                        # => Rolls back one exchange
 
# Context Management
/compress                               # => Manually trigger context compression
                                        # => Summarizes older messages
                                        # => Frees token budget for new messages
/usage                                  # => Show token usage for current session
                                        # => Output: input/output tokens, cost
 
# Personality and Skills
/personality scientist                  # => Switch to built-in persona (session only)
/skills                                 # => Browse available skills
                                        # => Shows installed skill names and descriptions
 
# Platform Status
/platforms                              # => Show connected platform status
                                        # => Lists: active channels, connection health

hermes claw migrate --dry-run           # => Preview migration without writing files
                                        # => Shows: what would be created/converted
                                        # => Shows: config format changes (JSON5 → YAML)
                                        # => Shows: directory mapping
                                        # => Safe to run repeatedly
 
hermes claw migrate --preset full       # => Full migration: config, memories, skills, auth
                                        # => Converts: openclaw.json → config.yaml
                                        # => Copies: memories/ → memories/
                                        # => Converts: skills/ → skills/
                                        # => Migrates: auth tokens and OAuth state
                                        # => Output: "Migrated 12 files, 3 skills"
 
hermes claw migrate --preset user-data  # => Migrate memories and preferences only
                                        # => Skips: API keys and auth tokens
                                        # => Skips: skill configurations
                                        # => Useful when re-entering credentials manually
                                        # => Output: "Migrated 4 files (user-data only)"

# Directory mapping (OpenClaw → Hermes):
# ~/.openclaw/openclaw.json       → ~/.hermes/config.yaml
#                                 # => JSON5 converted to YAML format
# ~/.openclaw/memories/MEMORY.md  → ~/.hermes/memories/MEMORY.md
#                                 # => Content preserved, no format change
# ~/.openclaw/memories/USER.md    → ~/.hermes/memories/USER.md
#                                 # => Content preserved, no format change
# ~/.openclaw/workspace/skills/   → ~/.hermes/skills/
#                                 # => SKILL.md files preserved
# ~/.openclaw/auth.json           → ~/.hermes/auth.json
#                                 # => OAuth tokens migrated