DEEN

Get Alran Code.

One line in your terminal. The installer checks your system, brings its own Node.js if needed and puts alran on your PATH.

curl -fsSL https://alran.dev/install.sh | bash

macOS · Linux · WSL · x64 and arm64

Every way in.

npm, pnpm, yarn, bun

With Node.js 22.19+ (22.x), 24.2+ (24.x), 25 or 26. Update later with alran update.

npm install -g alran

Windows

Run the installer inside WSL, or use npm in PowerShell.

npm install -g alran

VS Code and friends

The extension for VS Code, Cursor, Windsurf and VSCodium drives the CLI you installed.

From source

Git, Node.js and pnpm 9.12.0. The repository is MIT licensed.

git clone https://github.com/Alran-AI/code.git

Then three commands.

  1. 1

    Sign in

    Opens the Ottili sign-in. Over SSH you confirm a code instead.

    alran auth login
  2. 2

    Open your project

    Start Alran in the folder and say what you need.

    cd my-project && alran
  3. 3

    Write the project guide

    Alran studies the code and writes AGENTS.md.

    alran init .

Read the quickstart

What the installer does.

No surprises. Read it before you run it.

View install.sh

  • Checks for macOS or Linux on x64 or arm64.
  • Uses your Node.js if it fits; otherwise downloads Node.js 24 from nodejs.org and verifies its SHA-256.
  • Installs into ~/.alran-code, nothing system-wide, no sudo.
  • Adds one marked line to your shell’s startup file. ALRAN_NO_MODIFY_PATH=1 skips it.
  • Run it again to update. Remove ~/.alran-code to uninstall.

Need an account first?

Sign up on the Ottili AI Platform. The welcome credit covers Werk 1.1.