Skip to content

Installation

Requirements

  • Python ≥ 3.11
  • A modern terminal on macOS, Linux, or Windows

Isolinear is distributed on PyPI. No configuration is required before you install or run it — connection details are gathered interactively on launch.

Install

Run the latest version once, ephemerally, without installing anything:

uvx isolinear

Install isolinear (and the iso alias) onto your PATH:

uv tool install isolinear

Run once, or install persistently:

pipx run isolinear

pipx install isolinear

Running

Once installed, launch the app with either command:

isolinear

iso

Both open the workspace picker. See Connecting for what happens next.

Upgrading

uvx always fetches the latest published version, so there is nothing to upgrade. To refresh a cached run:

uvx isolinear@latest

uv tool upgrade isolinear

pipx upgrade isolinear

No config needed up front

Isolinear ships with sensible defaults and discovers your workspaces at runtime. You do not need to create a config file, set environment variables, or store a token before the first launch.