One command.
Any agent. Any OS.
The Gentleman AI ecosystem configurator — supercharge any AI coding agent with persistent memory, Spec-Driven Development, curated skills, and a teaching-oriented persona in seconds.
# One-liner install
curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash
# Scoop (recommended)
scoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket
scoop install gentle-ai
# Or via PowerShell
irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex
# Requires Go 1.24+
go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latest
Not an installer. An ecosystem.
Takes whatever AI coding agent you use and supercharges it with the entire Gentleman stack — in one command.
"I installed Claude Code / OpenCode / Cursor, but it's just a chatbot that writes code."
- No memory — starts fresh every session
- No structured workflow for big features
- Generic responses, no project context
- Manual MCP server setup
- No coding skill library
- One model fits all — no per-phase routing
"Your agent now has memory, skills, workflow, MCP tools, and a persona that actually teaches you."
- Persistent memory across every session (Engram)
- Spec-Driven Development for complex features
- Teaching-oriented persona with security guardrails
- Context7, Engram + more MCP servers pre-configured
- 14+ curated coding skills auto-loaded by context
- Per-phase model routing (OpenCode) or single-mode
8 agents. One setup.
Full delegation with sub-agents, or solo-agent with inline SDD — the installer handles it all.
Sub-agents, output styles
Per-phase model routing
Custom agents in ~/.gemini/agents/
9 SDD agents in ~/.cursor/agents/
Parallel execution via runSubagent
CLI-native, TOML config
Plan Mode, Code Mode, native workflows
Built-in Browser/Terminal sub-agents
Everything your agent needs to excel.
8 components. Pick what you want with presets or go fully custom.
Engram
engram Persistent memory
Cross-session memory via MCP. The agent saves decisions, discoveries, and bug fixes automatically. Search, filter, and browse from the terminal with `engram tui`.
SDD
sdd Spec-Driven Development
9-phase structured workflow for substantial features. Works organically — the agent suggests it when needed. Small tasks skip the ceremony entirely.
Skills
skills Curated skill library
14+ embedded skills auto-loaded by context. SDD phases, Go testing, branch/PR workflows, issue creation, Judgment Day adversarial review, and more.
Context7
context7 Live documentation MCP
MCP server for live framework and library documentation. Your agent queries real-time docs instead of hallucinating APIs from training data.
Persona
persona Teaching-oriented behavior
Gentleman, neutral, or custom persona mode. The agent explains WHY, pushes back on bad patterns, and actually teaches — not just executes blindly.
Permissions
permissions Security-first defaults
Pre-configured guardrails — no force pushes to main, no skipping hooks, no silent destructive operations. The agent asks before doing anything irreversible.
GGA
gga AI provider switcher
Gentleman Guardian Angel — switch AI providers via git hooks without changing your IDE. Per-project configuration, automatic credential rotation.
Theme
theme Kanagawa color overlay
The Gentleman Kanagawa theme — a dark, elegant color scheme injected into your agent's TUI for a cohesive visual experience.
Skills that load automatically.
14+ embedded skills organized by category. Your agent detects context and loads the right skills — zero configuration needed.
SDD Skills
Spec-Driven Development — 10 skills
sdd-init SDD Init
Bootstrap SDD context in a project
sdd-explore SDD Explore
Investigate codebase before committing to a change
sdd-propose SDD Propose
Create change proposal with intent, scope, approach
sdd-spec SDD Spec
Write specifications with requirements and scenarios
sdd-design SDD Design
Technical design with architecture decisions
sdd-tasks SDD Tasks
Break down a change into implementation tasks
sdd-apply SDD Apply
Implement tasks following specs and design
sdd-verify SDD Verify
Validate implementation matches specs
sdd-archive SDD Archive
Sync delta specs to main specs and archive
judgment-day Judgment Day
Parallel adversarial review — two independent judges
Foundation Skills
Workflow & tooling — 4 skills
go-testing Go Testing
Go testing patterns including Bubbletea TUI testing
skill-creator Skill Creator
Create new AI agent skills following the spec
branch-pr Branch & PR
PR creation with conventional commits and issue-first enforcement
issue-creation Issue Creation
Issue filing with bug report and feature request templates
Community Coding Skills
Framework-specific skills (React 19, Angular, TypeScript, Tailwind 4, Zod, Playwright…) maintained by the community in a separate repository.
Gentleman-Skills →Pick your setup level.
From zero-to-everything in one command. Re-run the installer anytime to change your config.
Full Gentleman
The complete experience
All 8 components + all skills + Gentleman persona. Maximum power, maximum teaching.
--preset full-gentleman Ecosystem Only
Core stack, no theme
Core components + all skills + Gentleman persona. Skip the visual theme if you prefer.
--preset ecosystem-only Minimal
Just the essentials
Engram memory + SDD skills only. For those who want the workflow without the extras.
--preset minimal Custom
Your choice, your rules
Pick exactly which components, skills, and persona you want. Full control over the stack.
--preset custom Your platform, your way.
Multiple install methods for macOS, Linux, and Windows. All lead to the same interactive TUI setup.
Homebrew
macOS / Linux
# Add the tap
brew tap Gentleman-Programming/homebrew-tap
# Install
brew install gentle-ai
curl
macOS / Linux
# One-liner
curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash
Scoop
Windows
# Add the bucket
scoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket
# Install
scoop install gentle-ai
Go install
Any platform
# Requires Go 1.24+
go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latest
After install — optional project setup
/sdd-init Bootstrap SDD context
Detects stack, testing capabilities, activates Strict TDD Mode. Run when starting a new project or after adding test frameworks.
Optional — the orchestrator runs this automatically if needed.
/skill-registry Build skill registry
Scans installed skills and project conventions. Re-run after installing or removing skills.
Optional — the orchestrator runs this automatically if needed.