Or if you prefer to look before you leap:
April 17, 2026 ยท View on GitHub

Give Claude Code a head start โ it'll feel like it's been on your team for years.
๐ฏ 21 Slash Commands โข โก 17 Shell Tools
๐ง Code Analysis โข ๐ค MCP Plugins โข ๐ช Automation Hooks
๐ฆ TypeScript/JS โข ๐ Python โข ๐น Go โข ๐ฆ Rust
Brought to you by
๐ What is AwesomeClaude?
Claude Code is already incredible โ but out of the box, it doesn't know anything about your project. Every new session, you're starting from scratch. AwesomeClaude fixes that.
One install gives Claude an instant understanding of your codebase, a library of ready-to-use workflows, and smart automations that run quietly in the background. It's built on Anthropic's own Claude Code Best Practices and installs in under a minute.
- โ
Instant project understanding โ One command (
chp) gives Claude everything it needs to know about your project. No explaining, no re-reading files every session. - โ
Complete workflows as slash commands โ
/start-feature,/debug-issue,/pre-deploy-checkโ whole multi-step workflows in a single command. - โ Catches problems early โ Automatically spots security issues, overly complex code, and common bug patterns before they ship.
- โ Runs quietly in the background โ Auto-formats your files after every edit, notifies you when a long task finishes. Set it once, forget about it.
- โ Connects to your tools โ Browser automation, live docs, GitHub, and more โ available when you need them, out of the way when you don't.
๐ Quick Install (30 seconds)
# 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 look before you leap:
git clone https://github.com/cassler/awesome-claude-code-setup.git && cd awesome-claude-code-setup && ./setup.sh && source ~/.zshrc
That's it! The setup script handles everything โ it detects what you already have, installs only what's needed, and works across all your projects from day one.
๐ฆ What Gets Installed?
- Helper scripts โ
~/.claude/scripts/(the engine under the hood) - Slash commands โ
~/.claude/commands/(the workflows you'll actually type) - Shell aliases โ Added to your
.zshrcor.bashrc(short commands likechp) - Global config โ
~/.claude/CLAUDE.md(tells Claude about the tools available) - Hooks config โ
~/.claude/settings.json(auto-format + notifications, skipped if you already have one) - Scoped rules โ
~/.claude/rules/(language-specific guidance that loads automatically)
๐ค Which Claude Model Should I Use?
| Model | Best For |
|---|---|
| Opus 4.7 | Big, complex tasks โ large refactors, tricky bugs, deep reasoning |
| Sonnet 4.6 | Your everyday go-to โ fast, smart, handles most things great |
| Haiku 4.5 | Quick questions, simple edits, when speed matters most |
Switch models anytime with
/modelin Claude Code, or use the model picker in the desktop app. Sonnet 4.6 is the default and a great starting point.
๐ Slash Commands โ Your Workflow Superpowers
Just type / in Claude Code to pull up any of these. They're full workflows โ not just prompts โ that walk Claude through each step automatically.
Building Features
- โจ
/start-featureโ Creates your GitHub issue, branch, and draft PR in one shot - ๐
/debug-issueโ Traces a bug step by step with root cause analysis - โ
/pre-review-checkโ Makes sure your code is ready before asking for a review - ๐ข
/pre-deploy-checkโ Runs through a full production-readiness checklist - ๐
/autofix-prโ Reads CI failures and review feedback, fixes what it can, pushes
Understanding Your Code
- ๐ง
/understand-codebaseโ Get up to speed on any project quickly - ๐
/explore-moduleโ Deep dive into how a specific module works - ๐ฆ
/analyze-dependenciesโ See what your project depends on and flag anything risky - ๐
/api-documenterโ Auto-generate documentation for your API endpoints - ๐ง
/refactor-assistantโ Walk through a refactor safely, step by step
Docs & Tracking
- ๐
/update-docsโ Keep documentation in sync with your code - ๐
/gather-tech-docsโ Pull together all the technical documentation in a project - ๐
/dev-diaryโ Track decisions and context as you build - ๐
/post-init-onboardingโ Get oriented in a brand new codebase quickly
Testing & Quality
- ๐งช
/tddโ Write your tests first, then build to make them pass - ๐จ
/visual-testโ Check for visual regressions using Playwright - ๐
/security-auditโ Scan for common security vulnerabilities - โก
/performance-checkโ Find the slow parts of your code - ๐ธ
/tech-debt-huntโ Surface the parts of the codebase that most need attention - ๐ฌ
/ultrareviewโ Run a thorough multi-angle review of everything on your branch
๐ช Background Automations (Hooks)
Hooks are little scripts that run automatically when Claude does something โ like a formatter that fires every time Claude edits a file, or a notification that pops up when a long task finishes.
Two hooks come included:
| Hook | When it runs | What it does |
|---|---|---|
| Auto-format | Every time Claude edits a file | Runs Prettier, Ruff, gofmt, or rustfmt depending on the file type |
| Task done | When Claude finishes working | Sends you a desktop notification so you can step away without babysitting |
These activate automatically when setup.sh installs ~/.claude/settings.json. If you already have that file, check out docs/hooks-guide.md to add them manually.
You can also write your own hooks โ block certain commands, log everything Claude touches, post to Slack when something finishes. The guide covers all of it.
๐ง Scoped Rules โ Claude Knows Your Style
Scoped rules are instructions for Claude that only activate when it's working on a specific type of file. So your TypeScript rules load when Claude opens a .ts file, your Python rules load for .py files, and so on โ without cluttering up every conversation.
Three rules come built in:
| Rule | Activates for | What it covers |
|---|---|---|
| TypeScript | .ts, .tsx, .js, .jsx | Type safety, async best practices, things to avoid |
| Python | .py | Type hints, modern Python patterns, formatting |
| Testing | Test files | How to write reliable, maintainable tests |
Where they live:
~/.claude/rules/โ installed bysetup.sh, apply across all your projects.claude/rules/in a repo โ apply only to that project
To add your own rule, create a file with this at the top:
---
globs: "**/*.ext"
---
Your rules go here.
๐ค MCP Plugins โ Connect Claude to More Tools
MCP plugins extend what Claude can do. The great thing is they only "wake up" when you actually use them โ so having them installed doesn't slow anything down.
| Plugin | What it gives Claude |
|---|---|
| Playwright | Control a real browser โ great for testing UI |
| Context7 | Up-to-date docs for any library or framework |
| Filesystem | Structured access to your files (optional, manual setup) |
| GitHub | Read and write issues, PRs, and code on GitHub (needs a token) |
| Sequential Thinking | Step-by-step structured reasoning for complex problems |
setup.sh handles Playwright and Context7 automatically. The others need a quick manual setup โ copy config/mcp.json to ~/.claude/mcp.json and fill in your paths and tokens (there are notes in the file explaining each one).
๐ ๏ธ Shell Helpers โ For Claude's Use (and Yours)
These are short commands that Claude uses behind the scenes to work faster in your project. You can run them yourself too!
chpโ Instant project overview. Run this first in any new project.chs find-code "something"โ Search your codebase fastchโ Access any helper:ch [category] [command]
| Category | Alias | What it does |
|---|---|---|
| project | p | Full project overview (chp) |
| search | s | Fast code and file search |
| git | g | Streamlined git workflows |
| docker | d | Container management |
| typescript | ts | Node.js/TypeScript tools |
| python | py | Python environment and testing |
| go | go | Go modules and testing |
| context | ctx | Generate focused context for a specific task |
| multi | m | Read or process multiple files at once |
| api | โ | Test HTTP endpoints |
| interactive | i | Pick files and branches interactively |
| nlp | text | Code analysis: complexity, security, duplication |
Run ch [category] help to see everything in any category.
๐ Code Analysis โ Spot Problems Before They Ship
The ch nlp tools let Claude (or you) analyze code without loading everything into the conversation. Run them before a PR to catch issues early.
ch nlp overview app.py # Full picture: complexity, security, quality, docs
ch nlp security auth.py # Check for accidental secrets or injection risks
ch nlp complexity utils.js # Find functions that are getting too tangled
ch nlp tokens bigfile.ts # See how large a file is before loading it
No extra tools needed โ everything runs with Python's built-in libraries.
๐ง Required & Optional Tools
Required (most systems already have these):
- ripgrep โ fast searching
- jq โ JSON processing
Optional (setup script will offer to install):
- fzf โ interactive file and branch picker
- bat โ syntax-highlighted file viewing
- gum โ nice-looking CLI prompts
- delta โ better git diffs
- httpie โ friendlier HTTP client
โ๏ธ Make It Yours
Add a new slash command:
- Create
commands/my-command.mdwith instructions for Claude - Run
./setup.sh - Use it as
/my-commandin Claude Code
Add a scoped rule:
- Create
.claude/rules/my-rule.md - Add
---\nglobs: "**/*.ext"\n---at the top - Write your rules โ Claude picks them up automatically
Add a helper script:
- Create
scripts/my-helper.sh - Run
./setup.sh - Access it via
ch myhelper
๐ค Contributing
Found a workflow that saves you time? A hook that's been useful? Add it and share it!
- Fork the repo
- Add your scripts or commands
- Open a pull request
๐ License
MIT License โ see LICENSE for details