claude-vibes-mcp

Claude Code vibe system — organize conversations by topic with automatic transcript export, session resumption, and MCP tool support.

Features

• Topic-based organization — group sessions by vibe name under ~/claude-exports/<vibe>/
• Auto-export — transcripts saved on session end and context compaction
• Attachment extraction — drag-and-drop images saved as viewable files
• Session resumption — resume any previous vibe with full context
• MCP tools — new_vibe, list_vibes, resume_vibe, format_vibe
• Status line — active vibe shown in Claude Code status bar

Requirements

• Node.js 18+
• Claude Code v2.1.25+
• jq (brew install jq on macOS)

Install

npx claude-vibes-mcp install

Or globally:

npm install -g claude-vibes-mcp
claude-vibes-mcp install

Restart Claude Code after installing.

Usage

In any Claude Code session:

new vibe bug-fix-auth        # start a new topic
list vibes                   # see all topics (top 15, sorted by date)
resume vibe bug-fix-auth     # pick up where you left off
format vibe bug-fix-auth     # export to markdown summary

Directory structure

~/claude-exports/
├── bug-fix-auth/
│   ├── attachments/
│   ├── project-vibe-20260413_091500.jsonl
│   └── summary.md
├── feature-dashboard/
│   └── project-session-20260412_140000.jsonl
├── extract-attachments.sh
├── format-transcript.sh
└── format-vibe.sh

What install does

1. Creates ~/claude-vibes/ and ~/claude-exports/
2. Copies shell scripts to ~/claude-exports/
3. Adds PreCompact + SessionEnd hooks to ~/.claude/settings.json
4. Adds mcpServers.vibes entry to ~/.claude/settings.json
5. Appends vibe commands to ~/.claude/CLAUDE.md

Existing settings are preserved — install is safe to run multiple times.

License

MIT