This is NOT an AI agent installer. Most agents are easy to install. This is an ecosystem configurator -- it takes whatever AI coding agent(s) you use and supercharges them with the Gentleman stack: persistent memory, Spec-Driven Development workflow, curated coding skills, MCP servers, an AI provider switcher, a teaching-oriented persona with security-first permissions, and per-phase model assignment so each SDD step can run on a different model.
Before: "I installed Claude Code / OpenCode / Cursor, but it's just a chatbot that writes code."
After: Your agent now has memory, skills, workflow, MCP tools, and a persona that actually teaches you.
| Agent | Delegation Model | Key Feature |
|---|---|---|
| Claude Code | Full (Task tool) | Sub-agents, output styles |
| OpenCode | Full (multi-mode overlay) | Per-phase model routing |
| Gemini CLI | Full (experimental) | Custom agents in ~/.gemini/agents/ |
| Cursor | Full (native subagents) | 9 SDD agents in ~/.cursor/agents/ |
| VS Code Copilot | Full (runSubagent) | Parallel execution |
| Codex | Solo-agent | CLI-native, TOML config |
| Windsurf | Solo-agent | Plan Mode, Code Mode, native workflows |
| Antigravity | Solo-agent + Mission Control | Built-in Browser/Terminal sub-agents |
Note: This project supersedes Agent Teams Lite (now archived). Everything ATL provided is included here with better installation, automatic updates, and persistent memory.
curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bashscoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket
scoop install gentle-aiOr via PowerShell script: irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex
Once your agents are configured, open your AI agent in a project and run these two commands to register the project context:
| Command | What it does | When to re-run |
|---|---|---|
/sdd-init |
Detects stack, testing capabilities, activates Strict TDD Mode if available | When your project adds/removes test frameworks, or first time in a new project |
skill-registry |
Scans installed skills and project conventions, builds the registry | After installing/removing skills, or first time in a new project |
These are not required for basic usage. The SDD orchestrator runs /sdd-init automatically if it detects no context. But if something changed in your project (new test runner, new dependencies), re-running them manually ensures the agents have up-to-date context.
brew tap Gentleman-Programming/homebrew-tap
brew install gentle-aigo install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latestscoop bucket add gentleman https://github.com/Gentleman-Programming/scoop-bucket
scoop install gentle-aiMigrating from PowerShell installer to Scoop? Remove the old binary first:
Remove-Item "$env:LOCALAPPDATA\gentle-ai" -Recurse -Force
# Then install via Scoop as shown above# Option 1: PowerShell installer (downloads binary from GitHub Releases)
irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex
# Option 2: Go install (requires Go 1.24+)
go install github.com/gentleman-programming/gentle-ai/cmd/gentle-ai@latestDownload the binary for your platform from GitHub Releases.
Every install, sync, and upgrade automatically snapshots your config files. Backups are compressed (tar.gz), deduplicated (identical configs are not re-backed up), and auto-pruned (keeps the 5 most recent). Pin important backups via the TUI (p key) to protect them from pruning.
See Backup & Rollback Guide for details.
| Topic | Description |
|---|---|
| Intended Usage | How gentle-ai is meant to be used — the mental model |
| Agents | Supported agents, feature matrix, config paths, and per-agent notes |
| Components, Skills & Presets | All components, GGA behavior, skill catalog, and preset definitions |
| Usage | Persona modes, interactive TUI, CLI flags, and dependency management |
| Backup & Rollback | Backup retention, compression, dedup, pinning, and restore |
| Platforms | Supported platforms, Windows notes, security verification, config paths |
| Architecture & Development | Codebase layout, testing, and relationship to Gentleman.Dots |
This project exists because of the community. See CONTRIBUTORS.md for the full list.
