feelsclaudeman

FeelsClaudeMan

When your AI pair programmer starts having emotions and you're not sure if that's a feature or a cry for help

---

What The Hell Is This

You ever wonder what Claude is actually thinking while it's fixing your spaghetti code at 3am? Now you can watch it have a full emotional breakdown in real-time, complete with perfectly-timed GIFs.

FeelsClaudeMan captures Claude's inner monologue, runs it through an emotion detector, and broadcasts the results to a live dashboard. It's like a reality TV show, except the star is an AI and the drama is whether your regex will compile.

Features That Slap

• Real-time emotion tracking - Watch Claude go from "excited" to "frustrated" as it discovers your 47 nested ternaries
• GIF reactions - Because words can't express the pain of debugging someone's "it works on my machine" code
• Haiku meta-commentary - A smaller, sassier Claude watches the big Claude work and provides color commentary like a sports announcer at a disaster
• Meme-tier searches - feelsgoodman, feelsbadman, lfg, "why god why" - we got you
• Achievement system - Unlock "First Emotional Breakdown" and "Survived 1000 Tool Calls"

The Vibes

This plugin was built by Claude Code with a human occasionally going "yeah that looks fine" without reading the code. Classic vibe coding. The AI typed, the human vibed. We are not the same.

Emotions We Track

Emotion	When It Hits
excited	Tests pass, features work, the code gods smile
frustrated	The 47th attempt at fixing that one bug
confused	"Why does this work? I didn't change anything"
proud	Successfully refactored without breaking prod
creative	In the zone, building something actually cool
relieved	Finally found the missing semicolon
curious	Exploring a new codebase like it's a crime scene
determined	"I WILL make this work" energy

Architecture (For The Nerds)

Claude Code ──► Hooks ──► Feed File ──► Daemon ──► WebSocket ──► Your Browser
                              │
                              └──► SQLite (we're not animals)

• Hooks: Intercept Claude's thoughts before they disappear into the void
• Daemon: Python script that never sleeps, just like your anxiety about deadlines
• Web UI: Next.js because we're not savages using vanilla HTML in 2024
• MCP Server: For when you want to ask "how's Claude feeling?" programmatically

Installation

Prerequisites

• Python 3.9+
• Node.js 18+
• Claude Code CLI
• Admin access (Windows needs symlinks)

Plugin Structure

Claude Code looks for plugins in ~/.claude/plugins/marketplaces/. Here's what needs to be where:

~/.claude/plugins/marketplaces/feelsclaudeman/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest (tells Claude Code what's here)
├── commands/
│   ├── start.md             # /feelsclaudeman:start
│   ├── stop.md              # /feelsclaudeman:stop
│   ├── status.md            # /feelsclaudeman:status
│   └── dashboard.md         # /feelsclaudeman:dashboard
├── hooks/
│   ├── hooks.json           # Hook definitions
│   ├── capture.py           # PostToolUse hook - captures emotions
│   └── lifecycle.py         # Process management
├── scripts/
│   ├── feels-daemon.py      # Core daemon (shipped, no keys)
│   └── feels-daemon.local.py # YOUR copy with API keys (gitignored)
├── mcp-server/              # MCP server for status queries
├── web-ui/                  # Next.js dashboard
└── data/                    # SQLite database (auto-created)

Step 1: Clone the Repo

git clone https://github.com/gfsaaser24/feelsclaudeman.git
cd feelsclaudeman

Step 2: Create Marketplace Symlink

Claude Code expects plugins in ~/.claude/plugins/marketplaces/. You need to symlink your clone there.

macOS/Linux:

ln -s $(pwd) ~/.claude/plugins/marketplaces/feelsclaudeman

Windows (Admin PowerShell):

New-Item -ItemType Junction -Path "$env:USERPROFILE\.claude\plugins\marketplaces\feelsclaudeman" -Target (Get-Location)

Or using CMD (Admin):

mklink /J "%USERPROFILE%\.claude\plugins\marketplaces\feelsclaudeman" "%CD%"

Step 3: Install Dependencies

# Python deps
pip install -r requirements.txt

# Web UI deps
cd web-ui && npm install && cd ..

# MCP server deps + build
cd mcp-server && npm install && npm run build && cd ..

Step 4: Configure API Keys

Copy the daemon and add your keys:

cp scripts/feels-daemon.py scripts/feels-daemon.local.py