DEEN

DokuLoslegen

Installieren

Eine Zeile auf macOS, Linux und WSL. Oder npm, überall wo Node.js läuft.

Wie installiere ich Alran Code?

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

Das Skript braucht nur curl (oder wget) und tar. Es:

  1. Prüft dein System: macOS oder Linux auf x64 oder arm64. WSL zählt als Linux.
  2. Nimmt dein Node.js, wenn die Version passt (22.19 oder neuer auf 22, 24.2 oder neuer auf 24, 25 oder 26). Sonst lädt es Node.js 24 von nodejs.org, prüft die SHA-256-Summe und legt es in den Installationsordner. Dein System-Node.js bleibt unberührt.
  3. Installiert das Paket alran nach ~/.alran-code und legt den Starter unter ~/.alran-code/bin/alran ab.
  4. Trägt den Ordner in die Startdatei deiner Shell in den PATH ein, markiert mit # Alran Code CLI.

Öffne danach ein neues Terminal und führ alran --version aus.

VariableWas sie tutStandard
ALRAN_INSTALL_DIRWohin Alran Code installiert wird~/.alran-code
ALRAN_VERSIONDie Version, die installiert wirdlatest
ALRAN_NO_MODIFY_PATH1 lässt deine Shell-Dateien in Ruhenicht gesetzt
bash
curl -fsSL https://alran.dev/install.sh | ALRAN_VERSION=0.6.9 bash

Lieber erst lesen? Herunterladen, lesen, dann ausführen: curl -fsSL https://alran.dev/install.sh -o install.sh, danach less install.sh und bash install.sh.

Mit npm

Node.js 22.19 oder neuer (22.x), 24.2 oder neuer (24.x), 25 oder 26. Node 24.0 und 24.1 werden nicht unterstützt.

bash
npm install -g alran
alran --version

pnpm, yarn und bun funktionieren genauso: pnpm add -g alran, yarn global add alran, bun add -g alran. Lass optionale Abhängigkeiten an und erlaube das native SQLite-Installationsskript von better-sqlite3 (npm tut das von sich aus). Gibt es für deine Node-Version kein fertiges Binary, brauchen native Abhängigkeiten Python und C/C++-Build-Tools.

Windows

Führ den Installer in WSL aus, oder installier mit npm in der PowerShell: npm install -g alran.

Aktualisieren

Installiert mitAktualisieren
npm, pnpm, yarn oder bunalran update
Dem InstallerDen Installationsbefehl erneut ausführen. Er ersetzt die Version an Ort und Stelle.

Alran Code sucht einmal pro Woche nach Updates und zeigt einen Hinweis. ALRAN_NO_UPDATE_CHECK=1 schaltet den Hinweis ab.

Deinstallieren

Schließ vorher laufende Sitzungen, auch in Editoren.

bash
# mit dem Skript installiert
rm -rf -- "$HOME/.alran-code"
# danach die Zeile "# Alran Code CLI" und die
# PATH-Zeile darunter aus deiner Shell-Datei entfernen

# mit npm installiert
npm uninstall -g alran

Anmeldung, Einstellungen und Sitzungen liegen getrennt in ~/.alran und bleiben erhalten. Lösch den Ordner nur, wenn auch sie weg sollen.

Aus dem Quellcode bauen

Du brauchst Git, Node.js (wie oben) und pnpm 9.12.0.

bash
git clone https://github.com/Alran-AI/code.git
cd code
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm alran --help

Einen Build aus dem Quellcode nutzt du in einem anderen Projekt über den absoluten Pfad: node /absoluter/pfad/zu/code/dist/cli.js.

Häufige Fragen

Wie installiere ich Alran Code unter macOS?

Führ im Terminal curl -fsSL https://alran.dev/install.sh | bash aus. Das Skript prüft, ob du macOS oder Linux auf x64 oder arm64 nutzt, installiert das alran-Paket nach ~/.alran-code, legt den Starter unter ~/.alran-code/bin/alran ab und trägt den Ordner in die PATH-Zeile der Startdatei deiner Shell ein. Wenn du lieber npm nimmst, funktioniert npm install -g alran überall dort, wo Node.js läuft.

Welche Node.js-Versionen unterstützt Alran Code?

Node.js 22.19 oder neuer auf 22.x, 24.2 oder neuer auf 24.x sowie 25 oder 26. Node 24.0 und 24.1 werden nicht unterstützt. Der Installer nimmt dein eigenes Node.js, wenn die Version passt, und lädt sonst Node.js 24 in den Installationsordner, ohne dein System-Node.js anzufassen.

Wie deinstalliere ich Alran Code, ohne meine Sitzungen zu verlieren?

Schließ zuerst laufende Sitzungen, dann lösch den Ordner ~/.alran-code (oder führ npm uninstall -g alran aus) und entferne die mit # Alran Code CLI markierte Zeile mitsamt der PATH-Zeile darunter aus der Startdatei deiner Shell. Anmeldung, Einstellungen und Sitzungen liegen getrennt in ~/.alran und bleiben erhalten, also lösch den Ordner nur, wenn auch sie weg sollen.