claude-den

Your cozy terminal den for Claude Code.

One command to set up the perfect terminal environment for Claude Code development.

Features

• Auto-detect terminal - Ghostty, iTerm2, Kitty, Alacritty, Warp, and more
• 5 built-in themes - Catppuccin Mocha, Nord, Tokyo Night, Dracula, Gruvbox
• Starship prompt - Claude Code-aware status line with git integration
• tmux layouts - Predefined workflows: coding, parallel agents, monitoring
• Backup & restore - Never lose your existing configs
• Doctor - Diagnose your terminal setup

Install

# Clone and install globally
git clone https://github.com/Longado/claude-den.git
cd claude-den
npm install && npm run build
npm link

# Now use it anywhere
den init

Or run directly without installing:

git clone https://github.com/Longado/claude-den.git
cd claude-den
npm install && npm run build
node dist/bin/den.js init

Commands

| Command | Description | |---------|-------------| | den init | Interactive setup wizard | | den theme list | Show available themes | | den theme preview <name> | Preview a theme's colors | | den theme apply <name> | Apply theme everywhere | | den layout list | Show available tmux layouts | | den layout start <name> | Launch a tmux layout | | den doctor | Check terminal capabilities | | den backup | Backup current configs | | den restore | Restore from backup |

Themes

| Theme | Description | |-------|-------------| | catppuccin-mocha | Soothing pastel with warm purple tones | | nord | Arctic, north-bluish palette | | tokyo-night | Clean dark, inspired by Tokyo city lights | | dracula | Dark theme with vibrant colors | | gruvbox | Retro groove with warm earthy tones |

Layouts

| Layout | Description | |--------|-------------| | coding | Claude Code left, shell right | | parallel | 2x2 grid for parallel Claude agents | | monitor | Claude + git + system monitor |

Supported Terminals

• Ghostty (recommended)
• iTerm2
• Kitty
• Alacritty
• Warp

Prerequisites

• Node.js >= 18
• Recommended: Maple Mono NF CN font
• Optional: Starship, tmux

Development

git clone https://github.com/Longado/claude-den.git
cd claude-den
npm install
npm test
npm run build

Roadmap

• Phase 2: Multi-agent orchestration (den agent spawn 3)
• Phase 3: Community theme engine (den theme publish)

License

MIT