Claude Code Setup Repository
A centralized collection of custom configurations, agents, commands, templates, and documentation for working with Claude Code.
What's Included
📊 Status Line Enhancement
- contextbricks - Real-time context tracking with brick visualization showing token breakdown, git status, model info, and session metrics
🤖 Custom Agents (agents/)
Specialized sub-agents with specific expertise:
- nixos-config-expert (Opus) - NixOS, Home Manager, and Nix flakes expert
- source-control-expert (Sonnet) - Jujutsu (jj), container registries, and version control
Learn more about agents →
⚡ Slash Commands (commands/)
Reusable prompts for common workflows:
- /jj-describe-all - Auto-describe all jj commits with conventional format
Learn more about commands →
🎣 Hooks (hooks/)
Automated behavior improvements that run at specific trigger points:
- forced-eval-skill - Dramatically improves skill activation reliability (84% vs 50% baseline)
Learn more about hooks →
🎨 Skills (skills/)
Interactive workflows for complex multi-step processes:
- consolidate-branches - Consolidate multiple PR branches using jj multi-parent rebase with intelligent AI-powered conflict resolution
Learn more about skills →
📝 Templates (templates/)
Starter templates for project documentation:
- CLAUDE-project.md.template - General software projects
- CLAUDE-docker.md.template - Docker/containerized services
- settings.local.json.template - Project-specific permissions
Learn more about templates →
🔌 MCP Servers (mcp-servers/)
Catalog of Model Context Protocol servers:
- mcp-ssh-unraid - 86 tools for Unraid server management
- mcp-filemanager - Privacy-preserving file operations
- serena - Semantic code analysis via language servers (runs via Nix)
Learn more about MCP servers →
📚 Documentation (docs/)
Comprehensive guides and learnings:
- global-instructions.md - Universal coding preferences
- best-practices.md - Hard-won knowledge from real issues
- permissions-guide.md - How to configure Claude Code permissions
Quick Start
Installation
Step 1: Install via Plugin Marketplace
In Claude Code, run the /plugin command and enter the repository path:
/plugin
> /home/jmo/Development/claude-setup
This installs all agents, commands, and templates automatically.
Step 2: Install Dependencies (includes contextbricks status line)
Navigate to the repository and install npm dependencies:
cd ~/Development/claude-setup
npm install
This will automatically install and configure:
- contextbricks - Real-time context tracking with brick visualization for your status line
Step 3: Symlink Global Instructions
Link the global instructions to your Claude Code config:
ln -sf ~/Development/claude-setup/docs/global-instructions.md ~/.claude/CLAUDE.md
Your existing ~/.claude/CLAUDE.md will be backed up to ~/.claude/CLAUDE.md.backup.
Step 4: Install Hooks (Recommended)
Install the forced eval hook to dramatically improve skill activation reliability:
mkdir -p ~/.claude/hooks
ln -sf ~/Development/claude-setup/hooks/forced-eval-skill.md ~/.claude/hooks/user-prompt-submit.md
This increases skill activation from ~50% to 84% success rate.
Step 5: Configure MCP Server Paths
⚠️ Important: Update the filesystem MCP server path to match your system:
# Edit .mcp.json and update the filesystem path
# Replace /home/jmo/Development with your actual development directory
Files to update:
.mcp.json - Line 19: Update filesystem args pathmcp-servers/filesystem.json - Line 7: Update filesystem args path
Step 6: Restart Claude Code
Restart Claude Code to load all components.
Creating a New Project
- Copy appropriate templates for your language (see
templates/LANGUAGE-GUIDE.md):
# For Rust projects
cp templates/CLAUDE-project.md.template ~/Development/my-app/CLAUDE.md
cp templates/settings-rust.json.template ~/Development/my-app/.claude/settings.local.json
# For Python projects
cp templates/CLAUDE-project.md.template ~/Development/my-app/CLAUDE.md
cp templates/settings-python.json.template ~/Development/my-app/.claude/settings.local.json
# See LANGUAGE-GUIDE.md for other languages
- Customize the templates with project-specific details
Updating
All updates happen automatically:
- Agents/Commands: Managed by plugin marketplace, auto-update
- Hooks: Symlinked, automatically use latest version from
hooks/
- Global Instructions: Symlinked, edit
docs/global-instructions.md directly
- Templates: Copy fresh templates when starting new projects
Repository Structure
jeprecated