Rupert CLI

Your computer's soul, embodied as a Glyphy Pet. A system monitor with personality.

Install

npm install -g rupert-cli

Quick Start

# One-shot system check with pet reaction
rupert

# Continuous overlay mode
rupert watch

# Get intelligent insights
rupert insights

# Get Claude-ready context
rupert context

# Kill top memory hogs
rupert kill-hogs

Commands

| Command | Description | |---------|-------------| | rupert | One-shot system check with pet reaction | | rupert watch | Continuous overlay mode (updates every 2s) | | rupert insights | Detailed breakdown with suggestions | | rupert context | Claude Code-ready system context | | rupert kill-hogs | Interactive process killer | | rupert ports | Port analysis with warnings | | rupert ollama | Ollama instance manager | | rupert pet [id] | Switch active pet (25 available) | | rupert pets | List all available pets |

Examples

One-shot check

$ rupert

  ╭────────────────────────────────────────╮
  │  🐾 RUPERT SAYS:                       │
  │  "😅 Memory's at 59% - I'm okay but    │
  │   watching closely!"                   │
  ╰────────────────────────────────────────╯

  📊 SYSTEM STATUS
  ┌─────────┬────────┬─────────┐
  │ Metric  │ Value  │ Status  │
  ├─────────┼────────┼─────────┤
  │ Memory  │ 59%    │ 🟡 WARN │
  │ CPU     │ 12%    │ 🟢 OK   │
  │ Ports   │ 23     │ 🟢 OK   │
  │ Procs   │ 187    │ 🟢 OK   │
  └─────────┴────────┴─────────┘

  👑 TOP HOGS
  chrome      15.2% mem   8.3% cpu
  node        8.1% mem     2.1% cpu
  ollama      6.4% mem     0.0% cpu

  💡 TIP: chrome eating 15% memory
     Run: rupert kill-hogs

Watch mode (overlay)

$ rupert watch

  ┌──────────────────────────────────────────┐
  │ 🐾 ashglyph  │ 💾 59% │ 🖥️ 12% │ 🔌 23 │
  │ "😅 Memory's at 59% - watching closely!" │
  └──────────────────────────────────────────┘
  
  Updates every 2 seconds. Ctrl+C to exit.

Get Claude context

$ rupert context

# Output is formatted for Claude Code:
# "System: macOS Darwin 24.0.0, Memory: 59% (14.2/24GB), CPU: 12%..."
# Paste into Claude Code for intelligent assistance.

Available Pets

25 Glyphy Pets across 4 seasons:

S1: Ember Fields (Fire/Magma)

• ashglyph, cinderpaw, frygar, geneblaze, molcano, scovillain, torchlette

S2: Tidepool (Water/Ice)

• reeflux, brinegrin, glacion, abyssule, dewdrift, tsunamini

S3: Canopy (Air/Flora)

• fernsprout, pollengust, barkalog, zephyrmite, shroomble, nesthawk

S4: Void Circuit (Tech/Cosmic)

• byteghost, staticlaw, nulliph, cosmoss, voxelisk, warpwell

# Switch pets
rupert pet glacion
rupert pet byteghost

Integration with Claude Code

# Get context, pipe to clipboard (macOS)
rupert context | pbcopy

# Then paste into Claude Code
# "Analyze my system and suggest optimizations"

API Mode (Connect to Zo Space)

# Use remote API for insights
rupert insights --api

# Get stats from your Zo
rupert stats --api https://yourhandle.zo.space

Configuration

Config stored at ~/.rupert/config.json

{
  "pet": "ashglyph",
  "refreshRate": 2000,
  "thresholds": {
    "memoryWarning": 50,
    "memoryCritical": 70,
    "cpuWarning": 50,
    "cpuCritical": 80
  },
  "apiEndpoint": "https://remysr.zo.space/api/rupert"
}

Requirements

• Node.js 18+
• macOS / Linux / Windows (WSL)

License

MIT

Links

• GitHub
• npm
• Glyphy Pets

Made with 🐾 by LoveLogicAI