Supercharge your Claude Code experience with lightning-fast commands and intelligent workflows.

🎯 19 Slash Commands • ⚡ 17 Shell Tools
🧠 NLP Analysis • 🤖 MCP Servers 💰 50-80% Token Savings
📦 TypeScript/JS • 🐍 Python • 🐹 Go • 🦀 Rust

Brought to you by

AwesomeClaude is based on Anthropic's Claude Code Best Practices - implementing their recommended patterns for reducing token usage through batched operations, improving speed by scripting repetitive tasks, ensuring consistency with standardized workflows, and maintaining minimal context overhead. Like a seasoned engineer, we focus on mastering the environment Claude works in - not just adding more tools, but building the right foundation. We add only ~300 tokens to Claude's context while providing professional-grade capabilities:

• ✅ Token-Conscious Bash - scripts, automations, and cli tools to minmize token usage while maximizing power.

• ✅ NLP-Powered Code Analysis - static analysis, code quality, and documentation insights without external dependencies.

• ✅ Thoughtful Batching - We keep complex business logic where it belongs: in code, not in Claude's context.

• ✅ SDLC Best-Practices - We provide complete workflows for feature development, debugging, testing, documentation, git ops and deployment with simple slash commands.

• ✅ MCP Server Integration - Seamlessly connect to Playwright and Context7 MCP servers for visual testing and always-current documentation.

# One-line install
curl -sSL https://raw.githubusercontent.com/cassler/awesome-claude-code-setup/main/setup.sh | bash && source ~/.zshrc

# Or if you prefer to review first:
git clone https://github.com/cassler/awesome-claude-code-setup.git && cd awesome-claude-code-setup && ./setup.sh && source ~/.zshrc

That's it! You now have instant access to powerful commands and workflows. Setup handles everything automatically!

• Detects existing servers to avoid duplicates
• Installs only what you need
• Works at user level - available in all projects
• Falls back to manual instructions if needed

1. Helper scripts → ~/.claude/scripts/
2. Slash commands → ~/.claude/commands/
3. Shell aliases → Added to your .zshrc or .bashrc
4. Global config → ~/.claude/CLAUDE.md (auto-updated)

Type / in Claude to access these complete workflows:

• ✨ /start-feature - Create issue, branch, and draft PR automatically
• 🐛 /debug-issue - Systematic debugging with root cause analysis
• ✅ /pre-review-check - Ensure code is review-ready
• 🚢 /pre-deploy-check - Production readiness verification

• 🧠 /understand-codebase - Get up to speed on any project quickly
• 📝 /update-docs - Keep documentation in sync with code
• 📚 /gather-tech-docs - Extract all technical documentation
• 🔍 /explore-module - Deep dive into module dependencies
• 📦 /analyze-dependencies - Comprehensive dependency audit
• 🌐 /api-documenter - Auto-generate API documentation
• 🔧 /refactor-assistant - Systematic refactoring workflow

• 🧪 /tdd - Test-driven development workflow
• 🎨 /visual-test - Visual regression testing
• 💸 /tech-debt-hunt - Find and prioritize technical debt
• 🔒 /security-audit - Comprehensive security vulnerability scan
• ⚡ /performance-check - Find performance bottlenecks

• 🔄 /commit-and-push - Complete git workflow with PR checks
• 📓 /dev-diary - Track development decisions
• 🚀 /post-init-onboarding - Systematic project onboarding

These aliases are primarily for Claude to efficiently execute tasks without loading documentation into context, but you can use them directly too:

• chp - Project overview - Get instant context about any codebase
• chs find-code "pattern" - Lightning-fast search using ripgrep
• ch - Main helper - Access any tool with ch [category] [command]

💡 Usage: ch [category] [command] or use shortcuts like chp, chs 📚 Full docs: Run ch [category] help to see all commands for any category

Powerful static analysis without external dependencies! Our NLP toolkit uses only Python's standard library to provide:

• ch nlp tokens file.py - Know the cost before reading files
• Smart batching - Check multiple files: ch nlp tokens src/*.js
• Prevent context bloat - Never accidentally load massive files

• ch nlp complexity file.py - Cyclomatic complexity scoring
• ch nlp security code.py - Find SQL injection, hardcoded secrets, unsafe operations
• ch nlp smells code.py - Detect long functions, deep nesting, magic numbers
• ch nlp duplicates src/ 5 - Find duplicate code blocks (5+ lines)
• ch nlp docs module.py - Documentation coverage analysis

• ch nlp summary README.md - Extract key points from documentation
• ch nlp keywords article.md 20 - Extract top keywords
• ch nlp readability docs.md - Calculate readability scores
• ch nlp sentiment "review text" - Analyze text sentiment

ch nlp overview app.py

Returns everything: complexity scores, security issues, code smells, documentation coverage, and improvement suggestions - all in one structured output!

• Claude makes multiple tool calls to gather project info
• You type long commands repeatedly
• Token usage adds up quickly
• Workflows vary between sessions

• One command (chp) = complete project context
• Shortcuts for everything (chs find-code "pattern")
• Batched operations save 50-80% on tokens
• AI-powered analysis (ch nlp overview file.py = complexity + security + quality)
• Token awareness (ch nlp tokens before reading large files)
• Consistent, reproducible workflows
• Your context stays clean for actual work

• ripgrep - Fast file searching (search-tools.sh)
• jq - JSON processing (project-info.sh, ts-helper.sh, api-helper.sh)

• fzf - Interactive fuzzy finder
• bat - Syntax highlighting
• gum - Beautiful CLI prompts
• delta - Enhanced git diffs
• httpie - Better HTTP client

The setup script will offer to install missing tools automatically.

1. Create script in scripts/my-helper.sh
2. Run ./setup.sh to install
3. Access via ch myhelper or add to main helper

1. Create markdown in commands/my-command.md
2. Run ./setup.sh to install
3. Use in Claude as /my-command

1. Fork the repository
2. Add your scripts/commands
3. Submit a pull request
4. Share your improvements!

MIT License - see LICENSE file for details