# muyue

AI-powered development environment assistant by **La Légion de Muyue**.

## What it does

`muyue` is a single binary that transforms your entire development environment:

- **Scans** your system for tools, runtimes, and configs
- **Installs** missing tools automatically (Crush, Claude Code, BMAD, Starship, runtimes...)
- **Updates** everything in the background
- **Profiles** you on first run to personalize the experience
- **Unifies** control of Crush and Claude Code from one TUI
- **Orchestrates** AI agents via MiniMax M2.7
- **Customizes** your terminal prompt (branch, commits, language, etc.)
- **Configures** MCP servers, LSPs, and skills automatically
- **Previews** HTML/visual outputs in your browser

## Tech Stack

- **Go** — single binary, no dependencies
- **Charm** — Bubble Tea, Lip Gloss, Huh (TUI, styling, forms)
- **Starship** — terminal prompt customization
- **MiniMax M2.7** — AI orchestration
- **BMAD-METHOD** — structured development workflows

## Install

```bash
go build -o muyue ./cmd/muyue/
```

Or with Make:

```bash
make build
make install-local
```

## Usage

```bash
muyue              # Start interactive TUI
muyue scan         # Scan system
muyue install      # Install missing tools
muyue update       # Check and apply updates
muyue setup        # Run setup wizard
muyue config       # Show configuration
```

## TUI Controls

| Key | Action |
|-----|--------|
| `1-4` | Switch tabs |
| `Tab` | Next tab |
| `q` / `Ctrl+C` | Quit |

## Configuration

Config stored at `~/.muyue/config.yaml`.

First run launches an interactive profiling wizard that:
1. Asks your name, pseudo, email
2. Detects your languages and editor
3. Chooses your AI provider
4. Scans your system
5. Installs missing tools

## Cross-Platform

Built for Linux (primary), macOS, and Windows. WSL supported.

## License

MIT