---
title: "Download Alran Code: one line for macOS, Linux and WSL"
url: https://alran.dev/en/download
locale: en
updated: 2026-11-16
---

# 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. {#h-ways}

### 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.

[About the extension](https://alran.dev/en/vscode) [GitHub](https://github.com/Alran-AI/vscode)

### 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. {#h-next}

1. **Sign in.** Opens the Ottili sign-in. Over SSH you confirm a code instead.alran auth login

2. **Open your project.** Start Alran in the folder and say what you need.cd my-project && alran

3. **Write the project guide.** Alran studies the code and writes AGENTS.md.alran init .

[Read the quickstart](https://alran.dev/en/docs/quickstart)

## What the installer does. {#h-what}

No surprises. Read it before you run it.

[View install.sh](https://alran.dev/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? {#h-close}

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

[Start free](https://ai.ottili.one) [GitHub](https://github.com/Alran-AI/code)
