Platform Support & Compatibility

Wardian is built to be a high-performance terminal environment, leveraging native OS capabilities where possible.

🏆 Windows (Native Support)

Windows is the primary development and testing platform for Wardian.

Implementation: Wardian uses portable-pty with native ConPTY support. This ensures a true, high-fidelity Windows terminal experience (supporting PowerShell 7, Git Bash, and CMD).
Nuance: On Windows, Wardian handles UNC path resolution for Gemini logs and session state navigation, preventing common "path not found" errors when working across drive letters.
Install: Use winget install WardianApp.Wardian, or download Wardian_X.Y.Z_x64-setup.exe from the Releases page.
Recommended Tools: We recommend using the latest PowerShell 7 for agent operations.

Wardian is fully supported on macOS, with a focus on Apple Silicon (M-series) performance.

Implementation: Standard Unix PTY via portable-pty.
Status: Stable. All core features (Library management, Workflows, Telemetry) are verified on macOS.
Install: Use brew install --cask wardian-app/tap/wardian, or download the Apple Silicon or Intel .dmg from the Releases page.
Visuals: The UI includes macOS-specific titlebar and sidebar width optimizations for a more native look and feel.

Wardian is fully supported on Linux.

Implementation: Standard Unix PTY via portable-pty.
Status: Stable. Core features verified on Linux. Distribution-specific shell environments are handled via the runtime shell selection feature.
Packages: .AppImage (portable, chmod +x and run) and .deb (install via sudo apt install ./Wardian_*.deb) are available from the Releases page.

If a terminal appears frozen or fails to render:

Check PTY Lifecycle: If the agent's PTY dies, the status will turn Gray (Off). Use the Restart action in the Command Matrix to re-initialize.
Provider Logs: Inspect the raw provider output using the Dynamic Terminal Grid (1x1 or focused view) to identify any CLI-level errors (e.g., authentication failure).
Shell Compatibility: Ensure the default shell on your system is supported by the agent provider you are using.