fix: restore mcp flexibility and improve cli tooling

docs/platform-support.md

@@ -0,0 +1,24 @@
+# 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.