coding-bro-ai

README

AI Gentle Stack

One command. Any agent. Any OS. The Coding Bro AI ecosystem -- configured and ready.

---

What It Does

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 Coding Bro 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.

8 Supported Agents

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.

---

Quick Start

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/CulenCode/coding-bro-ai/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/CulenCode/coding-bro-ai/main/scripts/install.ps1 | iex

This downloads the latest release for your platform and launches the interactive TUI. No Go toolchain required.

After install: project-level setup

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.

---

Install

Homebrew (macOS / Linux)

brew tap CulenCode/homebrew-tap
brew install coding-bro-ai

Go install (any platform with Go 1.24+)

go install github.com/maxculen86/coding-bro-ai/cmd/coding-bro-ai@latest

Windows (PowerShell)

# Option 1: PowerShell installer (downloads binary from GitHub Releases)
irm https://raw.githubusercontent.com/CulenCode/coding-bro-ai/main/scripts/install.ps1 | iex

# Option 2: Go install (requires Go 1.24+)
go install github.com/maxculen86/coding-bro-ai/cmd/coding-bro-ai@latest

From releases

Download the binary for your platform from GitHub Releases.

---

Documentation

Topic	Description
Intended Usage	How coding-bro-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
Platforms	Supported platforms, Windows notes, security verification, config paths
Architecture & Development	Codebase layout, testing, and relationship to CulenCode.Dots

---