Instalación 100% nativa en Windows 11. Sin WSL2, sin Linux, sin configuraciones complejas. Solo Git for Windows y dos comandos.
🙌 Open-source
Si te sirvió, dejá una ⭐ en el repo de GitHub.
Corre en PowerShell, CMD o Git Bash. Lee tu codebase, edita archivos y entiende el proyecto por lenguaje natural. Nativo en Windows desde 2025 — solo necesita Git for Windows.
Superpotencia Claude Code: memoria Engram, workflow SDD de 9 fases, 21 skills, Context7, GGA y persona mentora. Binario nativo de Go con installer PowerShell oficial.
Claude Code solo necesita Git for Windows. Gentle-AI es binario autocontenido; Go solo si usás go install.
winget install --id Git.Git -e --source winget git --version
winget install --id GoLang.Go -e go version
Descarga el binario compilado directamente desde GitHub Releases.
irm https://claude.ai/install.ps1 | iex claude --version
El método npm está deprecado. Alternativa: winget (no auto-actualiza).
# Inicia sesión interactiva — abre el browser vía OAuth claude # Alternativa: API key para headless/CI $env:ANTHROPIC_API_KEY = "sk-ant-TU-KEY-AQUI" claude
Necesitas Claude Pro/Max/Teams o billing en console.anthropic.com.
Claude Code funciona en PowerShell 7 (recomendado), CMD y Git Bash. Usá claude /help para ver todos los comandos.
irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex
go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latest gentle-ai --version
Solo el ejecutable gentle-ai.exe. Sin Node.js, Python ni Docker.
gentle-ai
gentle-ai install --agent claude-code --preset full-gentleman
gentle-ai install --agent claude-code --component engram,sdd,skills,context7,permissions --persona gentleman
Ver gentle-ai --help para todas las flags disponibles: --agent, --preset, --component, --skill, --persona, --dry-run.
Usá C:\dev\ o C:\Users\TuUsuario\proyectos\.
mkdir C:\dev\mi-app cd C:\dev\mi-app git init git commit --allow-empty -m "chore: init" gentle-ai install --agent claude-code --preset full-gentleman engram init claude
cd C:\dev\mi-proyecto-existente git status gentle-ai install --agent claude-code --preset full-gentleman engram init claude
Inyecta bloques sin borrar tu config. Backup en ~\.gentle-ai\backups\.
cd C:\dev\mi-app engram list claude
engram list engram search "arquitectura"
"Usemos SDD para implementar [feature]. Empezá por explore."
claude update irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex gentle-ai install --agent claude-code --preset full-gentleman
✅ Setup simple · 2 pasos
✅ Todo el ecosistema funciona
❌ Sin bash sandbox
→ Recomendado
⚠ Setup más complejo
✅ Todo el ecosistema funciona
✅ NemoClaw + bash sandbox
→ Solo si usás NemoClaw/OpenClaw
Windows nativo es suficiente y mucho más simple. Usá WSL2 solo si necesitás el bash sandbox o NemoClaw/OpenClaw.
| Problema | Causa | Solución |
|---|---|---|
claude no se reconoce | ~\.local\bin no está en el PATH | Cerrar y reabrir PowerShell. Si persiste, agregar $env:USERPROFILE\.local\bin al PATH de usuario. |
gentle-ai no se reconoce | El binario no está en el PATH | Agregar C:\Users\TuUsuario\go\bin al PATH (go install) o cerrar y reabrir PowerShell (installer). |
| Engram no recuerda el proyecto | Sin git init | git init && git add . && git commit -m "init" && engram init |
| Error de ejecución de scripts de PowerShell | Política restrictiva | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
| Claude Code pierde contexto en sesiones largas | Context window lleno | /clear y pedir que revise Engram. |
| Aspecto | Claude Code solo | + Gentle-AI |
|---|---|---|
| Memoria entre sesiones | Ninguna | Engram persiste todo |
| Proceso de desarrollo | Ad-hoc | SDD estructurado (9 fases) |
| Documentación de libs | Fecha de corte del modelo | Tiempo real con Context7 |
| Code review | Solo si lo pedís | Automático en cada commit |
100% native installation on Windows 11. No WSL2, no Linux, no complex configs. Just Git for Windows and two commands.
🙌 Open-source
If this helped you, leave a ⭐ on the GitHub repo.
Runs on PowerShell, CMD, or Git Bash. Reads your codebase, edits files, and understands the project through natural language. Native on Windows since 2025 — only needs Git for Windows.
Supercharges Claude Code: Engram memory, 9-phase SDD workflow, 21 skills, Context7, GGA, and mentor persona. Native Go binary with an official PowerShell installer.
Claude Code only needs Git for Windows. Gentle-AI is a self-contained binary; Go is only needed if you use go install.
winget install --id Git.Git -e --source winget git --version
winget install --id GoLang.Go -e go version
It downloads the compiled binary directly from GitHub Releases.
irm https://claude.ai/install.ps1 | iex claude --version
The npm method is deprecated. Alternative: winget (does not auto-update).
# Interactive login — opens browser via OAuth claude # Alternative: API key for headless/CI $env:ANTHROPIC_API_KEY = "sk-ant-YOUR-KEY-HERE" claude
You need Claude Pro/Max/Teams or billing at console.anthropic.com.
Claude Code works on PowerShell 7 (recommended), CMD, and Git Bash. Use claude /help to see all commands.
irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex
go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latest gentle-ai --version
Just the gentle-ai.exe executable. No Node.js, Python, or Docker.
gentle-ai
gentle-ai install --agent claude-code --preset full-gentleman
gentle-ai install --agent claude-code --component engram,sdd,skills,context7,permissions --persona gentleman
Run gentle-ai --help for all available flags: --agent, --preset, --component, --skill, --persona, --dry-run.
Use C:\dev\ or C:\Users\YourUser\projects\.
mkdir C:\dev\my-app cd C:\dev\my-app git init git commit --allow-empty -m "chore: init" gentle-ai install --agent claude-code --preset full-gentleman engram init claude
cd C:\dev\my-existing-project git status gentle-ai install --agent claude-code --preset full-gentleman engram init claude
Injects blocks without deleting your config. Backup at ~\.gentle-ai\backups\.
cd C:\dev\my-app engram list claude
engram list engram search "architecture"
"Let's use SDD to implement [feature]. Start with explore."
claude update irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex gentle-ai install --agent claude-code --preset full-gentleman
✅ Simple setup · 2 steps
✅ Full ecosystem works
❌ No bash sandbox
→ Recommended
⚠ More complex setup
✅ Full ecosystem works
✅ NemoClaw + bash sandbox
→ Only if you use NemoClaw/OpenClaw
Native Windows is enough and much simpler. Use WSL2 only if you need the bash sandbox or NemoClaw/OpenClaw.
| Problem | Cause | Solution |
|---|---|---|
claude not recognized | ~\.local\bin is not in PATH | Close and reopen PowerShell. If it persists, add $env:USERPROFILE\.local\bin to the user PATH. |
gentle-ai not recognized | Binary is not in PATH | Add C:\Users\YourUser\go\bin to PATH (go install) or close and reopen PowerShell (installer). |
| Engram doesn't remember the project | No git init | git init && git add . && git commit -m "init" && engram init |
| PowerShell script execution error | Restrictive policy | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser |
| Claude Code loses context in long sessions | Context window full | /clear and ask it to check Engram. |
| Aspect | Claude Code alone | + Gentle-AI |
|---|---|---|
| Memory between sessions | None | Engram persists everything |
| Development process | Ad-hoc | Structured SDD (9 phases) |
| Library docs | Model cutoff date | Real-time with Context7 |
| Code review | Only if you ask | Automatic on every commit |