adityahimaone/hermes-agent-rtk-caveman

🤖 Hermes Agent - RTK + Caveman Setup

A complete, ready-to-use Hermes Agent configuration with RTK (Rust Token Killer) and Caveman templating for 90-99% token savings on CLI operations.

✨ Features

• 90-99% token savings with RTK + Caveman
• 40+ pre-configured skills for common workflows
• Automated setup with one command
• Cross-platform support (macOS, Linux)
• Production-ready configuration

🚀 Quick Start

# Clone repository
git clone https://github.com/adityahimaone/hermes-agent.git
cd hermes-agent

# Run installer
chmod +x install.sh
./install.sh

# Reload shell
source ~/.zshrc

# Verify installation
verify-hermes

📊 Token Savings

📁 Repository Structure

hermes-agent/
├── README.md                    # This file
├── install.sh                   # Automated installer
├── .gitignore                   # Security (no secrets)
│
├── config/                      # Core configuration
│   ├── CLAUDE.md               # RTK instructions
│   └── default-personality.md  # Default AI personality
│
├── skills/                      # 40+ skills
│   ├── finance/                # Zenith Finance (5)
│   ├── productivity/           # Productivity tools (13)
│   ├── development/            # Dev tools (2)
│   ├── devops/                 # DevOps tools (4)
│   ├── github/                 # GitHub workflows (7)
│   ├── note-taking/            # Note tools (1)
│   └── research/               # Research tools (7)
│
├── scripts/                     # Wrapper scripts
│   ├── caveman_wrapper.sh      # General Caveman
│   ├── zenith_caveman.sh       # Finance Caveman
│   ├── verify_setup.sh         # Verification
│   └── demo_token_savings.sh   # Demo
│
├── templates/                   # Caveman templates
│   ├── git_status.txt
│   ├── lint_results.txt
│   └── test_results.txt
│
└── docs/                        # Documentation
    ├── SETUP_GUIDE.md
    ├── CAVEMAN_INTEGRATION.md
    └── TOKEN_OPTIMIZATION.md

🛠️ Included Skills

Finance (5)

• zenith-finance - Main finance manager
• zenith-finance-caveman-optimization - Token-efficient reports
• zenith-finance-gsheets-sync - Google Sheets sync
• zenith-finance-maintenance - File maintenance
• zenith-finance-sync - Auto-sync

Productivity (13)

• google-workspace - Gmail, Calendar, Drive
• google-workspace-setup - OAuth2 setup
• notion - Notion API
• obsidian - Obsidian vault
• linear - Linear issues
• nano-pdf - PDF editing
• powerpoint - PowerPoint creation
• ocr-and-documents - OCR for PDFs
• And more...

Development (2)

• caveman-rtk-integration - RTK + Caveman (90-99% savings)
• context-optimization - Memory management

DevOps (4)

• syncthing-setup - Folder sync
• mysql-service-manager - MySQL management
• git-ssh-custom-host - SSH config
• webhook-subscriptions - Webhooks

GitHub (7)

• github-auth - Authentication
• github-code-review - Code review
• github-issues - Issue management
• github-pr-workflow - Pull requests
• github-repo-management - Repositories
• And more...

Research (7)

• arxiv - Academic papers
• blogwatcher - Blog monitoring
• market-alpha-scout - Stock scanner
• polymarket - Prediction markets
• And more...

🔧 Configuration

RTK (Rust Token Killer)

RTK is configured in ~/.claude/CLAUDE.md:

## Golden Rule
**Always prefix commands with `rtk`**

## Examples
rtk git status          # 75% savings
rtk pnpm install        # 90% savings
rtk next build          # 87% savings

Caveman Templates

Templates are in ~/templates/:

cgs                    # Git status (compact)
cgl 20                 # Git log (last 20)
clint src/             # Lint results
ctest 'npx vitest run' # Test results

Shell Aliases

Add to ~/.zshrc:

# Caveman shortcuts
alias cgs='~/bin/caveman_wrapper.sh git-status'
alias cgl='~/bin/caveman_wrapper.sh git-log'
alias clint='~/bin/caveman_wrapper.sh lint'
alias ctest='~/bin/caveman_wrapper.sh test-results'

# RTK shortcuts
alias gs='rtk git status'
alias gl='rtk git log --oneline -10'
alias gd='rtk git diff'

📖 Usage Examples

Git Operations

# Instead of:
git status              # 500-2000 tokens

# Use:
rtk git status          # 100-400 tokens (80% savings)
# Or:
cgs                     # 50-200 tokens (90% savings)

Finance Reports

# Recent transactions
zrt 10

# Monthly summary
zms 2026-04

# Net worth
znw

Development

# Run tests
ctest 'npx vitest run'

# Build project
rtk next build

# Lint code
clint src/

🎨 Customization

Change Personality

Edit config/default-personality.md:

## Communication Style
- **Language**: English
- **Tone**: Professional
- **Pronouns**: I/you

Add Custom Skills

# Create skill directory
mkdir -p ~/.hermes/skills/custom/my-skill

# Create SKILL.md
cat > ~/.hermes/skills/custom/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: My custom skill
category: custom
---
# My Skill
...
EOF

Create Custom Templates

# Create template
cat > ~/templates/my_template.txt << 'EOF'
{{- for d.items as item }}
{{item}}
{{- end }}
EOF

# Use template
~/bin/caveman ~/templates/my_template.txt /tmp/data.json

🔒 Security

• ✅ No API keys in repository
• ✅ No personal data exposed
• ✅ .gitignore configured
• ✅ All secrets excluded

📊 Performance

🆘 Troubleshooting

Command Not Found

# Check PATH
echo $PATH | grep ~/bin

# Add to PATH
export PATH="$HOME/bin:$PATH"
source ~/.zshrc

RTK Not Working

# Check RTK
which rtk
rtk gain

Templates Not Found

# Check templates
ls -la ~/templates/

# Reinstall
./install.sh

📚 Documentation

• Setup Guide
• Caveman Integration
• Token Optimization

🤝 Contributing

1. Fork repository
2. Create feature branch
3. Make changes
4. Test thoroughly
5. Submit pull request

📄 License

MIT License - Free to use and modify.

👤 Author

Hermes Agent Community

🔗 Links

• Hermes Agent GitHub
• RTK Documentation
• Caveman npm

Version: 1.0.0 Last Updated: 2026-04-13 Status: Production-ready ✅