Claude Dotfiles
iamnolanhu/claude-dotfiles
Configuração modular e portátil do Claude com perfis adaptativos
Ver no GitHubSistema portátil de configuração do Claude com setup baseado em perfis (Desktop/VPS). Monta automaticamente camadas de CLAUDE.md, integra MCP servers e fornece scripts cross-platform para gerenciamento de subagentes e limpeza de processos órfãos.
Instalação
npx convez-ai iamnolanhu/claude-dotfiles1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Configurar ambientes Claude idênticos em múltiplas máquinas
- Gerenciar MCP servers e plugins por perfil (desktop vs. headless)
- Manter infraestrutura e credenciais seguras sem versionamento
- Automatizar limpeza de subagentes e processos órfãos
Veredito

Dotfiles bem arquitetado para quem trabalha com Claude em múltiplos ambientes. Sistema de camadas (base → perfil → local) é elegante e resolve o problema real de sincronizar configurações sem expor dados sensíveis. Implementação shell é robusta, mas requer familiaridade com linha de comando.
README
A tradução para o português deste README ainda está na fila.
claude-dotfiles
Portable Claude Code configuration with profile-based setup. One repo, works on any machine — desktop or headless VPS.
What this does
- Layered CLAUDE.md — generic base + environment profile + personal overlay
- Profile system — desktop (full browser tools, opus) vs VPS (headless, sonnet, minimal plugins)
- Interactive installer — picks profile, sets GitHub username, configures MCP servers
- Cross-platform scripts — OS-aware (macOS + Linux) subagent cleanup, statusline, gate scripts
- No personal info committed — infrastructure, IPs, SSH shortcuts live in gitignored
.local/
Quick start
git clone https://github.com/iamnolanhu/claude-dotfiles.git
cd claude-dotfiles
./setup.sh
The installer will:
- Ask your machine type (Desktop / VPS)
- Ask your GitHub username (optional, for commit policy)
- Ask if you want AI attribution hidden in commits
- Link settings, scripts, and statusline to
~/.claude/ - Assemble
CLAUDE.mdfrom base + profile + local layers - Walk you through MCP server selection
Structure
claude-dotfiles/
├── setup.sh # Interactive installer
├── base/
│ └── CLAUDE.md # Generic instructions (no personal info)
├── profiles/
│ ├── desktop/
│ │ ├── CLAUDE.md # Browser automation priorities
│ │ └── settings.json # Full plugins, opus, prettier hook
│ └── vps/
│ ├── CLAUDE.md # Headless constraints, resource limits
│ └── settings.json # Minimal plugins, sonnet, docker perms
├── examples/
│ └── local-CLAUDE.md # Template for personal config
├── .local/ # Gitignored — your machine-specific config
│ └── CLAUDE.md # Infrastructure, SSH, self-hosted services
├── scripts/
│ ├── cleanup-subagents.sh # Kill stale subagents by age + count
│ ├── code-simplifier-gate.sh # Cooldown gate for code review hook
│ └── kill-all-orphans.sh # Nuclear cleanup for orphaned processes
├── statusline.sh # Multi-line statusline (git, cost, context %)
├── .env.example # API key template
└── .gitignore
How CLAUDE.md assembly works
Your final ~/.claude/CLAUDE.md is built from three layers:
| Layer | Source | Contains |
|---|---|---|
| Base | base/CLAUDE.md | Package managers, tool priorities, engineering standards, subagent rules |
| Profile | profiles/<profile>/CLAUDE.md | Desktop: browser tools. VPS: headless constraints |
| Local | .local/CLAUDE.md | Your infrastructure, SSH hosts, self-hosted service URLs |
Run ./setup.sh update after editing any source layer to reassemble.
Profiles
Desktop
- Full plugin set (26 plugins including agent-browser, frontend-design)
- Browser automation tool priority (agent-browser > chrome-devtools > playwright)
- Prettier formatting hook on file writes
- Code simplifier gate on session stop
- Default model: opus
VPS
- Same plugins, hooks, and model as desktop (minus browser-specific: agent-browser, frontend-design, vercel, stripe)
- No browser tools offered during MCP setup
- Docker, systemctl, and journalctl permissions added
- Default model: opus
Commands
./setup.sh # Initial setup (profile + integrations)
./setup.sh add <name> # Add/enable a single MCP integration
./setup.sh list # Show all integrations and their status
./setup.sh env KEY [v] # Add an API key to ~/.claude/.env
./setup.sh update # Pull latest and reassemble config
Personalizing
After running setup, edit .local/CLAUDE.md with your machine-specific config. See examples/local-CLAUDE.md for the template. Common additions:
- Server IPs and Tailscale topology
- SSH shortcuts and port forwards
- Self-hosted service URLs (crawl4ai, n8n, etc.)
- Project template references
- File sharing and sync setup
MCP Integrations
| Integration | Needs API Key | Desktop Only |
|---|---|---|
| context7 | ||
| serena | ||
| morphllm-fast-apply | ||
| chrome-devtools | yes | |
| firecrawl | yes | |
| github | yes | |
| openrouter | yes | |
| apify | yes | |
| digitalocean | yes | |
| n8n | yes | |
| crawl4ai | yes | |
| playwright | yes | |
| browser-tools | yes | |
| magic | yes |