Guide · Updated 2026-06-12
Install Liminal on Windows
Install the native desktop app or use PowerShell for the CLI harness. Node.js 22+, an API key, and your first agent turn in minutes.
Desktop app (recommended for most users)
Download the Windows installer from the get-started page. You get the Integrations hub (Gmail, Slack, Xero, Microsoft 365), live tool streaming, and email compose preview without touching the terminal.
The desktop app bundles liminald sidecar and launches the agent against your chosen workspace folder.
Prerequisites (CLI path)
Node.js 22 or newer.
An API key from OpenRouter, OpenAI, or another compatible provider.
Git for Windows (recommended for clone-based install).
CLI install
Open PowerShell and run: irm https://www.vireondynamics.com/install/install.ps1 | iex
Follow prompts to set AGENT_API_KEY in `.env`. The script installs npm workspaces and can open the web UI.
Run
npm run web from the cloned liminal-ai folder for the browser UI on port 3001.
npm run tui for the terminal UI if you prefer keyboard-first workflows.
Set AGENT_WORKSPACE_ROOT to your project path so file and git tools target the right repo.
Windows-specific notes
- PowerShell is the default shell for run_shell; approval gates apply to destructive commands.
- Playwright browser tools need Chromium: run npm run browser:install once in the repo.
- WSL2 works but the native desktop app is simpler for OAuth connectors.
FAQ
Common questions
Does Liminal work on Windows ARM?
If Node.js 22+ runs on your device, Liminal should run. Playwright browser tools may need extra Chromium setup.
Desktop app vs CLI on Windows?
Use the desktop app for integrations and email. Use CLI if you live in the terminal or automate headless runs on a dev machine.
Can I use Ollama on Windows?
Yes. Install Ollama for Windows, point AGENT_API_BASE_URL at http://127.0.0.1:11434/v1, and set AGENT_MODEL to your pulled tag. See the Ollama guide.