claude-setup-repository

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 path
• mcp-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

1. 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

2. 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