# Platform Support

Owlen targets all major desktop platforms; the table below summarises the current level of coverage and how to verify builds locally.

| Platform | Status | Notes |
|----------|--------|-------|
| Linux    | ✅ Primary | CI and local development happen on Linux. `owlen config doctor` and provider health checks are exercised every run. |
| macOS    | ✅ Supported | Tested via local builds. Uses the macOS application support directory for configuration and session data. |
| Windows  | ⚠️ Preview | Uses platform-specific paths and compiles via `scripts/check-windows.sh`. Runtime testing is limited—feedback welcome. |

### Verifying Windows compatibility from Linux/macOS

```bash
./scripts/check-windows.sh
```

The script installs the `x86_64-pc-windows-gnu` target if necessary and runs `cargo check` against it. Run it before submitting PRs that may impact cross-platform support.

### Troubleshooting

- Provider startup failures now surface clear hints (e.g. "Ensure Ollama is running").
- The TUI warns when the active terminal lacks 256-colour capability; consider switching to a true-colour terminal for the best experience.

Refer to `docs/troubleshooting.md` for additional guidance.