✨ Features

• 🔍 Auto-detection — discovers monorepos and detects Node, PHP, React Native, Python, and Go ecosystems automatically
• 🔨 Turbo-powered — all task execution goes through Turborepo for caching, parallelism, and dependency ordering
• 🧹 Universal cleanup — one command cleans build artifacts, caches, and dependencies across all ecosystems
• 📊 Workspace overview — git status, ecosystem badges, and workspace info at a glance
• 🎨 Beautiful UI — interactive prompts, spinners, tables, and ASCII banner via @clack/prompts
• 📦 JSON output — --json flag for CI/CD pipelines and scripting
• 🏗️ Class-based DI — commands are @Injectable() classes powered by @stackra/ts-container
• 🏷️ Decorator metadata — @Command() decorator for name, description, emoji, category, and aliases

📥 Install

# Global install
pnpm add -g @stackra/mono-cli

# Or run directly
npx @stackra/mono-cli

🚀 Quick Start

# Show workspace status (default command)
mono

# Clean across all repos
mono clean build          # build artifacts only
mono clean all            # everything

# Run turbo tasks
mono build                # build all repos
mono lint                 # lint all repos
mono test                 # test all repos

# Git operations
mono git status           # status across all repos
mono git push "message"   # commit + push all repos

# Dependency graphs
mono graph                # interactive HTML graph
mono graph -f mermaid     # Mermaid diagram

# CLI info
mono about                # banner + registered commands

📋 Commands

| Command | Emoji | Description | | ------------------- | ----- | ---------------------------------------- | | mono status | 📊 | Show workspace overview and git status | | mono clean [mode] | 🧹 | Clean artifacts, caches, or dependencies | | mono build | 🔨 | Build all repos via turbo | | mono lint | 🔍 | Lint all repos via turbo | | mono test | 🧪 | Test all repos via turbo | | mono dev | 🚀 | Start dev servers via turbo | | mono format | ✨ | Format code with prettier | | mono git status | 📊 | Git status across repos | | mono git push | 📤 | Commit + push all repos | | mono graph | 🕸️ | Generate dependency graphs | | mono about | ℹ️ | Show CLI info and registered commands |

🎛️ Global Flags

| Flag | Description | | ------------------- | ------------------------------ | | --json | Output as JSON (for CI/piping) | | --no-interactive | Disable prompts (for CI) | | -r, --repo <name> | Target specific repo(s) | | --verbose | Show detailed output | | -v, --version | Show version |

🌐 Ecosystem Support

The CLI auto-detects monorepo types by checking for config files:

| Ecosystem | Detected By | Badge | | ------------- | ---------------------- | ----- | | Node / TS | package.json | 🟢 | | PHP / Laravel | composer.json | 🐘 | | React Native | app.json + expo deps | 📱 | | Python | pyproject.toml | 🐍 | | Go | go.mod | 🔵 |

🧹 Clean Modes

mono clean build    # dist, coverage, .next, vendor/public/build
mono clean cache    # turbo, eslint, tsbuildinfo, bootstrap/cache
mono clean deps     # node_modules, vendor, lockfiles
mono clean tmp      # .DS_Store, Thumbs.db
mono clean all      # everything

🏗️ Architecture

The CLI uses a class-based DI architecture:

@Command({
  name: 'build',
  description: 'Build all repos via turbo',
  emoji: '🔨',
  category: 'tasks',
  aliases: ['b'],
})
@Injectable()
class BuildCommand extends BaseCommand {
  async handle(args: string[], opts: GlobalOptions): Promise<void> {
    // ...
  }
}

Commands are registered in CliModule and resolved via @stackra/ts-container at bootstrap time.

📦 Dependencies

• commander — command parsing
• @clack/prompts — interactive UI
• chalk — terminal colors
• execa — subprocess execution
• @stackra/ts-container — dependency injection

📄 License

MIT © Stackra L.L.C