DokuLoslegen
Installieren
Eine Zeile auf macOS, Linux und WSL. Oder npm, überall wo Node.js läuft.
Wie installiere ich Alran Code?
curl -fsSL https://alran.dev/install.sh | bashDas Skript braucht nur curl (oder wget) und tar. Es:
- Prüft dein System: macOS oder Linux auf x64 oder arm64. WSL zählt als Linux.
- 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.
- Installiert das Paket
alrannach~/.alran-codeund legt den Starter unter~/.alran-code/bin/alranab. - Trägt den Ordner in die Startdatei deiner Shell in den
PATHein, markiert mit# Alran Code CLI.
Öffne danach ein neues Terminal und führ alran --version aus.
| Variable | Was sie tut | Standard |
|---|---|---|
ALRAN_INSTALL_DIR | Wohin Alran Code installiert wird | ~/.alran-code |
ALRAN_VERSION | Die Version, die installiert wird | latest |
ALRAN_NO_MODIFY_PATH | 1 lässt deine Shell-Dateien in Ruhe | nicht gesetzt |
curl -fsSL https://alran.dev/install.sh | ALRAN_VERSION=0.6.9 bashLieber 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.
npm install -g alran
alran --versionpnpm, 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 mit | Aktualisieren |
|---|---|
| npm, pnpm, yarn oder bun | alran update |
| Dem Installer | Den 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.
# 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 alranAnmeldung, 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.
git clone https://github.com/Alran-AI/code.git
cd code
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm alran --helpEinen 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.