# 4Runr OS - Quick Setup Guide

## One-Time Setup

**Step 1: Install**
```bash
npm install -g 4runr-os
```

**Step 2: Run Setup (Auto-detects and fixes everything)**
```bash
4runr-setup
```

Or if that doesn't work:
```bash
npm run -g setup
```

**That's it!** The setup script will:
- ✅ Check Node.js and npm
- ✅ Install Rust if needed
- ✅ Fix Windows MSVC linker issues automatically
- ✅ Build mk3-tui binary
- ✅ Verify everything is ready

## Daily Use

```bash
4r
```

**Done!** Just `4r` every time. It will verify everything is ready before launching.

---

## After Setup

Once installed, just run:

```bash
4r
```

That's all you need! The `4r` command will:
- ✅ Launch the 4Runr OS terminal interface
- ✅ Auto-update when new versions are available
- ✅ Work immediately (no additional setup needed)

---

## Troubleshooting

### "4r: command not found"

Make sure npm global bin is in your PATH:

**Windows:**
```powershell
# Add to PATH (add to your PowerShell profile)
$env:Path += ";$env:APPDATA\npm"
```

**Linux/macOS:**
```bash
# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH=$PATH:$(npm config get prefix)/bin
```

### "mk3-tui binary not found"

This shouldn't happen if binaries are included in the package. If you see this:

1. Make sure you have the latest version: `npm install -g 4runr-os@latest`
2. If still happening, the package will try to build from source automatically (requires Rust)

---

## That's It!

- **One-time setup**: `npm install -g 4runr-os`
- **Daily use**: `4r`

No other commands needed! 🚀

