convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
iamnolanhu

Claude Dotfiles

iamnolanhu/claude-dotfiles

Configuração modular e portátil do Claude com perfis adaptativos

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema 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-dotfiles

1 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

Estrelas
2
Forks
2
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

  1. Ask your machine type (Desktop / VPS)
  2. Ask your GitHub username (optional, for commit policy)
  3. Ask if you want AI attribution hidden in commits
  4. Link settings, scripts, and statusline to ~/.claude/
  5. Assemble CLAUDE.md from base + profile + local layers
  6. 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:

LayerSourceContains
Basebase/CLAUDE.mdPackage managers, tool priorities, engineering standards, subagent rules
Profileprofiles/<profile>/CLAUDE.mdDesktop: browser tools. VPS: headless constraints
Local.local/CLAUDE.mdYour 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

IntegrationNeeds API KeyDesktop Only
context7
serena
morphllm-fast-apply
chrome-devtoolsyes
firecrawlyes
githubyes
openrouteryes
apifyyes
digitaloceanyes
n8nyes
crawl4aiyes
playwrightyes
browser-toolsyes
magicyes
Ver o original no GitHub

Bom para

Relacionados