owlen/docs/platform-support.md

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

./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.