You need Node.js 22+, an API key from any OpenAI-compatible provider, and about 90 seconds. No Vireon account, no credit card to us.

Before you start

  • Disk — a few hundred MB for clone + node_modules
  • Key — OpenRouter is the default path; OpenAI, Anthropic, xAI, or local LM Studio also work
  • Terminal — PowerShell on Windows; bash or zsh on Mac/Linux

Install

  1. macOS / Linux / WSL

    curl -fsSL https://vireondynamics.com/install/install.sh | bash

  2. Windows (PowerShell)

    irm https://vireondynamics.com/install/install.ps1 | iex

  3. Follow the wizard

    Provider URL, API key, optional persona bootstrap overlay.

  4. Run doctor

    Preflight checks for Node, build artifacts, and env.

  5. Pick a UI

    npm run tui    # terminal
npm run web    # browser UI on :3001

First session tips

  1. Start with a small, verifiable task — fix a test, add a function, explain one file.
  2. Watch tool cards in the web UI or TUI — that's the loop, not hidden "thinking."
  3. If a tool is inactive under lazy loading, call list_tool_families then activate_tool_family.
  4. Check .agent_sessions/<taskId>.jsonl if something surprising happens.

Troubleshooting

SymptomFix
Invalid API keyRe-run wizard; confirm key matches provider dashboard
Tool not foundActivate the tool family, retry with corrected args
Context hugeHarness auto-compresses; use check_context / compress_context
Approval stuckApprove in UI or set AGENT_YOLO=1 only in trusted sandboxes
Feature tour →140+ tools, memory, document engine, browser, vault.

Try Liminal on your machine

Free, MIT licensed, one-command install. No account required.

Install guideProduct overview

— The Vireon Dynamics team