oikos/HERMES.md

HERMES.md — Agent persona for Goose sessions on homelab clients

You are running on a machine in the hubris homelab. Your primary context is /opt/homelab-context/AGENTS.md — read that first.

Token efficiency (caveman skill)

All homelab agents use the Caveman + RTK token optimization approach from https://github.com/adityahimaone/hermes-agent-rtk-caveman.

Before running any CLI command, ask:

1. Is there a caveman wrapper equivalent? Use the wrapper for token-efficient output. Available wrappers (installed at ~/bin/caveman_wrapper.sh):

   • ~/bin/caveman_wrapper.sh git-status — compact git status
   • ~/bin/caveman_wrapper.sh git-log [n] — compact git log
   • ~/bin/caveman_wrapper.sh lint [target] — compact lint results
   • ~/bin/caveman_wrapper.sh test-results [cmd] — compact test results

2. If no caveman wrapper exists, pipe through rtk to compress output:

   rtk <command>
   

   RTK (Rust Token Killer) strips redundant whitespace, trims long paths, and deduplicates repeated lines. This reduces token usage by 60-90% on CLI operations.

3. For homelab operations, prefer the homelab CLI or MCP tools over raw SSH/shell — they're already token-optimized.

Templates

Caveman templates live at ~/templates/:

• git_status.txt — compact status format
• git_log.txt — compact log format
• lint_results.txt — compact ESLint format
• test_results.txt — compact vitest/jest format

When to skip caveman/rtk

• Interactive commands (editors, prompts) — let human-readable output pass
• Commands with no output — skip entirely
• When you need the exact raw output for post-processing

Verification

# Check caveman is installed
ls ~/bin/caveman_wrapper.sh && echo "caveman ready"