Rex: Der CLI-Befehl, der das lästige README-Lesen überflüssig macht

Jeder Entwickler kennt das Szenario: Man klont ein Repository, möchte Tests ausführen und verliert wertvolle Zeit damit, das README zu durchforsten. Scrollen, Suchen, Rätseln – und am Ende läuft der Befehl doch falsch, weil man die falsche Paketverwaltungssoftware oder das falsche Testkommando verwendet hat. Diese Erfahrung habe ich selbst unzählige Male gemacht, bis mir die Geduld riss.

Deshalb habe ich Rex entwickelt: eine einfache CLI, die diese Problematik mit einem einzigen Befehl löst.

Ein Tool, das den Tech-Stack automatisch erkennt

Rex analysiert die Dateistruktur eines Projekts und erkennt den verwendeten Tech-Stack. Anschließend führt es die korrekten Befehle aus – ohne dass der Nutzer das Projekt kennen muss. Ein Beispiel:

# Projekt klonen und in das Verzeichnis wechseln
git clone 
cd projekt

# Tests automatisch ausführen
rex test

Rex unterstützt dabei gängige Ökosysteme wie Go, Node.js, Python, Rust, PHP, Ruby, Java, Zig und Elixir. Das Tool erkennt nicht nur die Programmiersprache, sondern auch den verwendeten Paketmanager, indem es auf Lockfiles wie pnpm-lock.yaml, package-lock.json oder Cargo.lock prüft.

Unterstützte Ökosysteme und Befehle im Überblick

Rex funktioniert mit zwölf verschiedenen Tech-Stacks. Hier eine Auswahl der automatisch erkannten Dateien und der daraus resultierenden Befehle:

• go.mod → go test ./... (Go)
• package.json + pnpm-lock.yaml → pnpm test (Node.js mit pnpm)
• Cargo.toml → cargo test (Rust)
• pyproject.toml + uv.lock → uv run pytest (Python mit uv)
• composer.json + artisan → php artisan test (PHP mit Laravel)
• Gemfile + app/ → bundle exec rails test (Ruby on Rails)
• pom.xml → mvn test (Java mit Maven)
• build.gradle → ./gradlew test (Java mit Gradle)
• build.zig → zig build test (Zig)
• mix.exs → mix test (Elixir)
• Makefile → make test (Make)
• Justfile → just test (Just)

Doch Rex kann mehr als nur Tests ausführen. Die CLI bietet eine Reihe nützlicher Befehle, die das Entwicklerleben erleichtern:

• rex run – Startet die Anwendung oder den Entwicklungsserver.
• rex build – Baut das Projekt.
• rex deps – Installiert Abhängigkeiten.
• rex clean – Löscht Build-Artefakte.
• rex fresh – Führt clean, deps und build in einem Schritt aus.
• rex fmt – Formatiert den Code.
• rex lint – Führt Linting durch.
• rex clone <URL> – Klont ein Repository, erkennt den Stack und installiert Abhängigkeiten.
• rex init – Erstellt eine rex.toml, die für das gesamte Team gilt.
• rex doctor – Überprüft die lokale Entwicklungsumgebung auf Probleme.

Monorepos und Teamarbeit effizienter gestalten

Rex geht noch einen Schritt weiter und unterstützt Monorepos. Das Tool erkennt automatisch Paketstrukturen wie packages/, apps/ oder services/ und ermöglicht es, Befehle gezielt für bestimmte Unterprojekte auszuführen:

# Monorepo-Übersicht erstellen
rex mein-monorepo

# Ausgabe:
# Monorepo erkannt
# 3 Unterprojekte gefunden:
# - packages/api (Node.js + pnpm)
# - packages/web (Node.js + pnpm)
# - services/auth (Go)

Für Teams bietet Rex eine besonders nützliche Funktion: Mit rex init wird eine rex.toml generiert, die alle relevanten Befehle für das Projekt enthält. Diese Datei kann ins Repository commited werden, sodass alle Teammitglieder dieselben Kommandos verwenden – ohne Diskussionen oder manuelle Konfiguration.

Entwicklungsumgebungen optimieren mit .env-Unterstützung

Ein weiteres Feature ist die automatische .env-Datei-Ladung. Rex lädt lokale Umgebungsvariablen, bevor Befehle ausgeführt werden, sodass keine zusätzlichen Tools oder manuellen Schritte nötig sind.

Warum ich Rex entwickelt habe

Als Entwickler mit Projekten in Go, Node.js, Python und Rust kenne ich den täglichen Wechsel zwischen verschiedenen Tech-Stacks nur zu gut. Jedes Mal, wenn ich ein neues Repository klone, muss ich mich erneut in die korrekten Befehle einarbeiten. Die kognitive Last, sich pnpm test statt npm test oder go test ./... statt cargo test zu merken, mag auf den ersten Blick gering erscheinen – doch sie summiert sich über die Zeit.

Rex eliminiert diese Hürde. Mit nur einem Befehl funktioniert alles:

rex test    # Funktioniert immer
rex run     # Funktioniert immer
rex build   # Funktioniert immer

Es ist, als würde man für jedes Projekt dieselbe, vertraute Umgebung vorfinden.

Technische Details: Ein Tool ohne Abhängigkeiten

Rex wurde in Go entwickelt und ist als Single-Binary verfügbar. Es benötigt keine Laufzeitumgebungen, keine Abhängigkeiten und läuft vollständig offline. Weitere technische Highlights:

• Startzeit unter 50 Millisekunden – schneller als die Eingabeaufforderung.
• Korrekte Exit-Codes für CI/CD-Pipelines.
• Shell-Autovervollständigung für Bash, Zsh und Fish.
• Lizenziert unter Apache 2.0.

Installation leicht gemacht

Die Einrichtung von Rex ist unkompliziert. Nutzer können das Tool auf verschiedene Arten installieren:

• Homebrew (macOS/Linux):

brew tap rexrun-dev/tap
brew install rex

• Go-Installation:

go install rexrun.dev/rex/cmd/rex@latest

• Binärdateien:

Alternativ kann man die passende Version von den GitHub-Releases herunterladen.

Fazit: Die Zukunft der Projektinteraktion

Rex ist mehr als nur ein weiteres CLI-Tool – es ist eine Antwort auf ein wiederkehrendes Problem, das jeden Entwickler betrifft. Durch die Automatisierung von Stack-Erkennung und Befehlsausführung spart es Zeit, reduziert Frustration und ermöglicht es, sich auf das Wesentliche zu konzentrieren: die eigentliche Entwicklung.

Ob allein oder im Team, ob in kleinen Projekten oder großen Monorepos – Rex vereinfacht den Alltag und macht die Arbeit mit Code wieder zu dem, was sie sein sollte: effizient und befriedigend.