monitor-config

# Monitor Configuration Assistant

Optimize multi-monitor setups on macOS through an interactive interview process. Discover connected displays, understand the user's physical arrangement and workflow, then configure optimal resolutions, refresh rates, and orientations.

## Requirements

- macOS
- `displayplacer` CLI tool (will prompt to install if missing)

## Workflow

### Step 1: Ensure displayplacer is Installed

Check if displayplacer is available:

```bash
command -v displayplacer || echo "NOT_INSTALLED"
```

If not installed, offer to install:

```bash
brew install displayplacer
```

### Step 2: Discover Connected Displays

Run displayplacer to get full display information:

```bash
displayplacer list
```

Parse and present the displays in a clear format:

```
I found these displays:

1. [Type] - [Size] inch
   - Current: [resolution] @ [hz]Hz
   - Rotation: [degrees]
   - Position: [origin]

2. ...
```

Identify each display by:
- Serial screen ID (persistent across reboots)
- Type (MacBook built-in, external)
- Size (27 inch, 32 inch, etc.)

### Step 3: Interview About Physical Setup

Ask about the physical arrangement:

1. "Which monitor is in front of you (center)?"
2. "What's to your left? Right?"
3. "Are any monitors rotated vertically (portrait mode)?"
4. "Roughly how far do you sit from your displays? (helps determine optimal resolution)"

### Step 4: Interview About Use Case

Ask about primary use:

1. "What do you primarily use this setup for?"
   - Programming/code reading
   - Video editing/media production
   - General productivity
   - Gaming
   - Mixed use

2. "Do you prefer maximum sharpness (smaller text) or comfortable readability (larger text)?"

3. "Is smooth scrolling important to you? (120Hz vs 60Hz)"

### Step 5: Analyze and Recommend

Based on the interview, reference `references/resolution_guidelines.md` for optimal settings.

Consider:
- **4K displays**: Can run at native 4K, scaled 1440p, or scaled 1080p
- **Portrait orientation**: