🚀 Broz — Developer Workspace Manager

The fastest and smartest way for developers to create projects, save templates, learn project structures, clone repositories, and use AI to automate development tasks.

---

✨ Features

Command	Description
broz start <name>	Create a new project with an interactive TUI wizard
broz start --quick <name>	Quick mode — only ask language & framework
broz follow	Learning mode — analyze project architecture
broz save <name>	Save current project as a reusable template
broz use	Create a project from a saved template
broz delete	Delete a saved template
broz clone	Clone a repo with analysis and post-clone options
broz check	Check installed development tools
broz config	View and edit Broz configuration
broz ai	AI-powered development assistant
broz update	Update Broz and templates

🛠️ Supported Languages & Frameworks

Language	Frameworks
🐍 Python	FastAPI, Django, Flask
🔵 Go	Gin, Fiber, Echo
🟨 JavaScript	Express, NestJS
🔷 TypeScript	Express, NestJS
⚛️ React	Vite, Next.js
▲ Next.js	App Router
☕ Java	Spring Boot
🟣 Kotlin	Ktor
🦀 Rust	Actix Web

📦 Installation

# With pipx (recommended)
pipx install broz

# With pip
pip install broz

# From source
git clone https://github.com/sameetpatro/broz.git
cd broz
uv sync
uv run broz --help

🚀 Quick Start

# Create a new FastAPI project
broz start my-api

# Quick mode (uses defaults)
broz start --quick my-api

# Check your dev environment
broz check

# Learn a project's structure
cd existing-project
broz follow
broz save my-template

# Use a saved template
broz use

# AI-powered project creation
broz ai

⚙️ Configuration

Broz stores configuration in ~/.bro/config.yaml:

default_language: python
default_framework: fastapi
always_git: true
always_docker: false
always_testing: true
always_linter: true

Edit interactively with broz config.

🏗️ Architecture

bro/
├── cli/          # Typer CLI entry point
├── tui/          # Textual TUI screens & widgets
├── ai/           # LLM client & prompts
├── templates/    # Jinja2 templates & registry
├── generators/   # Project component generators
├── config/       # YAML configuration management
├── github/       # Device flow auth & repo creation
├── clone/        # Repository cloning & analysis
├── follow/       # Project learning & template extraction
├── commands/     # One module per command
├── models/       # Pydantic data models
└── utils/        # Cross-platform helpers

🤖 AI Features

Broz AI requires an API key:

broz config
# Set ai_api_key to your OpenAI API key

• Build Something: Describe what you want, AI generates the project plan
• Debug Project: Paste errors, AI diagnoses and suggests fixes
• Improve Project: AI analyzes your project and suggests improvements

📄 License

MIT License — see LICENSE for details.

---

Built with ❤️ using Typer, Textual, and Jinja2