convez.ai
MCP ServerDevOps & InfraestruturaIniciante
episuarez

init-claude — Setup Automático de Claude Code

episuarez/initialiser

Um comando para configurar Claude Code perfeitamente em qualquer projeto

Ver no GitHub
InicialPluginScore · de 0 a 100

Um comando único que detecta automaticamente sua stack de projeto e instala os MCP servers, skills e ferramentas mais adequados via interface interativa. Configura componentes core (context-mode, reasoning), análise de código, automação web, orquestração de agentes e hooks Git — tudo pronto para uso com Claude Code.

Instalação

$npx convez-ai episuarez/initialiser

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
3
Forks
1
Acompanhando
0
Saúde
57%
Último commit
há 2 meses
Versão
v1.2.1
Issues abertas
7
Contribuidores
1

Casos de uso

  • Configurar novo projeto com Claude Code em segundos
  • Instalar MCP servers e skills recomendados por stack detectada
  • Automatizar setup de git hooks, testes e análise de código
  • Orquestrar múltiplos agentes Claude para tarefas paralelas grandes

Veredito

Ferramenta essencial que reduz significativamente o atrito de onboarding com Claude Code. Auto-detecção de stack é inteligente e a TUI interativa deixa clara cada decisão — recomendado para qualquer projeto novo.

README

A tradução para o português deste README ainda está na fila.

init-claude

init-claude wizard

One command to set up Claude Code the right way — in any project.

npm Version CI License Node.js Platform Claude Code


Install

Requires Node.js ≥ 18.

Option A — npm (recommended)

npm install -g @episuarez/init-claude

Option B — git clone (with auto-update)

git clone https://github.com/episuarez/initialiser %LOCALAPPDATA%\init-claude
cd %LOCALAPPDATA%\init-claude && npm install --omit=dev

Add %LOCALAPPDATA%\init-claude to your PATH. init-claude update will pull new versions automatically.

Then, from any project:

init-claude

What it does

Scans your project (languages, frameworks, size, CI, docs, design files), recommends the right Claude Code components and skills, and installs them — MCPs registered, CLAUDE.md written, git hooks wired.

ComponentGroupWhat it does
context-modeCoreSession memory + output sandbox. Cuts context waste by ~98%.
sequential-thinkingCoreStructured reasoning for architecture and design decisions.
code-review-graphAnalysisCodebase dependency graph: impact analysis, multi-file search.
serenaAnalysisSemantic LSP: go-to-definition, find-references, precise symbol search.
playwrightWebBrowser automation, scraping, E2E testing via MCP.
context7WebUp-to-date library docs (React, Next.js, FastAPI…) fetched at runtime.
claude-flowOrchestrationMulti-agent swarm / hive-mind for large parallel tasks.
SuperClaudeOrchestration30 /sc:* workflow slash commands.
husky + lint-stagedGitPre-commit hooks: lint and tests before every commit.
RTKOptimizationCompresses Bash output 60–90% (git, npm, cargo, test runners).
MarkItDownDocumentsConverts PDF/Word/Excel/PPT to Markdown for Claude to read.
PencilDesignVector design .pen files + pencil-to-code skill.
Figma Dev ModeDesignReads Figma designs (requires Figma desktop + Dev seat).

Project skills installed per-stack: frontend-components · api-design · unity-conventions · e2e-testing · python-quality


Usage

init-claude                    Interactive wizard (recommended)
init-claude --yes              Apply recommended defaults without prompts
init-claude check              Doctor: show what's installed, no changes made
init-claude update             Self-update the app (git pull + npm install)
init-claude upgrade            Update installed components (npm, pipx, cargo)
init-claude add-skill <id>     Install a skill from the built-in catalog
init-claude add-skill <url>    Install a skill from any raw URL or GitHub repo
init-claude --version          Print version and exit

Your own rules — user-rules.md

On first run, init-claude creates user-rules.md in the app directory. Anything you write below the --- separator is injected as a section into every CLAUDE.md the tool generates, in every project.

  • Gitignored — init-claude update never touches it.
  • Edit once, every future run picks it up automatically.
  • Per-project rules go in the CUSTOM block of each project's CLAUDE.md (also survives regeneration).
%LOCALAPPDATA%\init-claude\user-rules.md   ← global personal rules (all projects)
<project>\CLAUDE.md  CUSTOM block          ← rules for that project only

Where session memory lives

Context-mode stores data globally — not in your project:

~/.claude/context-mode/
├── content/     indexed tool outputs (SQLite, hashed names)
└── sessions/    session memory (same scheme)

Query from inside Claude Code with ctx_search or ctx stats. Don't browse the files directly.


Extending the catalog

Add a component — edit catalog/components.json. No code changes needed:

{
  "id": "my-tool",
  "name": "My Tool",
  "group": "Analysis",
  "desc": "Short description shown in the wizard.",
  "recommendIf": ["frontend", "large"],
  "alwaysOn": false,
  "install": { "type": "npm", "pkg": "my-tool" },
  "mcp": { "name": "my-tool", "cmd": "npx -y my-tool-mcp" },
  "claudemd": "- `my-tool`: one-line hint injected into CLAUDE.md."
}

Add a project skill — drop a .md file in catalog/skills/ and add a record to projectSkills in components.json.

Remote skill registry — create config.json with { "registryUrl": "https://..." } pointing to a { "skills": [...] } JSON. The wizard will offer those skills on every run.

See CONTRIBUTING.md for full details.


Installation options

Option A — npm installs globally via npm. Update with npm update -g @episuarez/init-claude. No git required.

Option B — git clone supports init-claude update (git pull + npm install) and lets you edit the catalog locally. Checks for updates once a day silently.

Option C — without Git — run install.cmd. Copies the app and updates PATH. No auto-update.

init-claude upgrade updates the installed components (Claude Code CLI, context-mode, pipx packages, RTK) regardless of which installation option you used.


Requirements

  • Node.js ≥ 18
  • Git (option A + auto-update)
  • Claude Code CLI — npm install -g @anthropic-ai/claude-code
  • Python + pipx — optional (code-review-graph, MarkItDown, SuperClaude)
  • Rust + cargo — optional (RTK)
  • uv — optional (serena)

License

MIT with Commons Clause. Free for personal, open-source, and internal use. Attribution required on forks. Commercial redistribution requires a separate license — contact.

See LICENSE for full terms.


Author

Epifanio Suárez Martínez — if you fork this, keep the attribution. If you build something commercial on top of it, let's talk.

Ver o original no GitHub

Bom para

Relacionados