Zum Inhalt springen
Chapters
  1. Willkommen bei Omarchy!
  2. Erste Schritte
  3. Von Mac oder Windows kommen
  4. Navigation
  5. Die obere Leiste
  6. Themes
  7. Tastenkombinationen
  8. Einheitliche Zwischenablage & Verlauf
  9. Erinnerungen
  10. Hinweise
  11. Textextraktion & Diktat
  12. Screenshots & Aufnahme
  13. Toggles, Leerlauf und der Bildschirmschoner
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Entwicklungs-Tools
  19. Shell-Werkzeuge
  20. Shell-Funktionen
  21. TUIs
  22. GUIs
  23. Browser
  24. Kommerzielle Apps/Dienste
  25. Web-Apps
  26. Gaming
  27. PDFs ausfüllen
  28. Windows-VM
  29. Andere Pakete
  30. Updates
  31. Dotfiles
  32. Shell-Plugins
  33. Monitore
  34. Tastatur, Maus, Trackpad
  35. Netzwerk
  36. Ruhezustand des Systems
  37. Hardware-Authentifizierung
  38. Schriftarten
  39. Hintergründe
  40. Prompt
  41. Branding
  42. Häufige Anpassungen
  43. Dein eigenes Theme erstellen
  44. Mac-Unterstützung
  45. Fehlerbehebung
  46. Häufige Fragen
  47. Systemsnapshots
  48. Sicherheit
  49. Omarchy auf...
  50. Dual-Boot-Installation
  51. Unbeaufsichtigte Installationen

Handbuch

Entwicklungs-Tools

Alternative Editoren

Omarchy liefert standardmäßig Neovim aus, aber wenn du etwas gängigeres und vertrauteres möchtest, kannst du das Omarchy Menu (Super + Space) öffnen und dir die Optionen unter Install > Editor ansehen. Dort sind VSCode, Cursor, Zed, Sublime Text, Helix, Vim und Emacs aufgeführt. Wenn du nicht findest, wonach du suchst, schau unter Install > Package nach, ob es nicht als Arch-Paket verfügbar ist (und falls nicht, versuche Install > AUR, um in AUR nachzusehen).

Der ursprüngliche vi-Editor ist ebenfalls von Haus aus verfügbar. Führe vi filename aus, um eine Datei im Terminal zu bearbeiten.

Eine Theme-Anpassung wird für VSCode, Cursor, VSCodium und Helix angeboten.

Den systemweiten Standard-Editor kannst du unter Setup > Defaults > Editor festlegen.

Umgebung

Omarchy unterstützt die Einrichtung einer ganzen Reihe von Entwicklungsumgebungen über den Bereich Install > Development des Omarchy Menu (Super + Space). Dort findest du natürlich Ruby on Rails, aber auch alle drei großen Laufzeitumgebungen für JavaScript (Node.js, Bun, Deno) sowie beliebte PHP-Frameworks wie Laravel und Symfony. Oh, und Go, Rust, Python, Java, Elixir (mit Phoenix), .NET, OCaml, Zig, Clojure und Scala gibt es auch. Es ist eine sehr breite Auswahl!

Die meisten dieser Umgebungen werden von Mise verwaltet. Es ist ein Tool, mit dem du mehrere Versionen einer Programmiersprache auf derselben Maschine installieren und ausführen kannst. Es ist wie rbenv oder rvm für Ruby oder virtualenv für Python, funktioniert aber für eine ganze Reihe verschiedener Umgebungen.

Um beispielsweise Ruby zu installieren, würdest du mise use -g ruby ausführen. Dadurch wird Ruby sowohl installiert als auch als globaler Standard festgelegt. Oder wenn dein Projekt eine .ruby-version-Datei hat, kannst du einfach mise i im Stammverzeichnis dieses Projekts ausführen.

Vorinstallierte CLI-Tools

Omarchy stellt Tools wie gh, uv und die meisten Coding-Agenten über mises Lazy-Installation bereit. Beim ersten Ausführen eines solchen Tools installiert mise es. Spätere Ausführungen verwenden die installierte Version wieder; sie suchen nicht bei jedem Start nach einem Update.

Du kannst dir die Standardeinstellungen auch ansehen oder sie im Voraus installieren:

mise ls --current              # List the tools configured for this directory
mise install gh               # Install one tool now
mise install --include-lazy    # Install all configured tools, including lazy tools

Führe omarchy update aus, um installierte Tools zusammen mit dem restlichen Omarchy zu aktualisieren. Der Alias mup aktualisiert nur die von mise verwalteten Tools. Um ein weiteres Tool zu deiner eigenen Konfiguration hinzuzufügen, verwende mise use -g <tool>.

Die Python-Einrichtung installiert über mise auch uv. Wenn du die Python-Entwicklungsumgebung entfernst, bleibt uv als eigenständiges Tool verfügbar.

Eigene Installation verwenden

Die Befehle von mise stehen auf PATH vor ~/.local/bin. Ein Tool, das du selbst installiert hast, beispielsweise mit dem eigenen Installer von Claude Code oder Cursor, führt daher trotzdem mises Kopie aus. Vom Desktop gestartete Apps finden mises Befehle ebenfalls vor Systempaketen. Eine App, die gh ausführt, erhält also mises Kopie, selbst wenn du github-cli mit pacman installiert hast, und mise installiert diese Kopie beim ersten Mal. Um stattdessen deine eigene Installation zu verwenden, deaktiviere mises Kopie in ~/.config/mise/config.toml. Wenn du beispielsweise die Cursor CLI selbst installiert hast:

[settings]
disable_tools = ["cursor-agent"]

Wenn du bereits eine [settings]-Tabelle hast, füge den Eintrag dort hinzu; erweitere eine vorhandene disable_tools-Liste, anstatt sie zu ersetzen. Stelle sicher, dass sich deine Installation auf PATH befindet. Verwende den mise-Toolnamen, der von seinem Befehl abweichen kann: oh-my-pi stellt beispielsweise omp bereit. Der Launcher für den Standard-Agenten bevorzugt ebenfalls einen von dir installierten Cursor oder Muse in ~/.local/bin.

Standardeinstellungen entfernen und wiederherstellen

Bei Remove Preinstalls überspringt mise Omarchys Tool-Deklarationen für deinen Benutzer, indem sie zu ignored_config_paths in ~/.config/mise/miserc.toml hinzugefügt werden. Restore Preinstalls entfernt diese Zeile wieder. Tools, die du selbst deklarierst, in deiner eigenen Konfiguration oder in der mise.toml eines Projekts, funktionieren in beiden Fällen weiterhin. Wenn du nach dem Entfernen der Vorinstallationen einen Standard-Agenten auswählst oder Python einrichtest, wird dieses Tool zu deiner eigenen Konfiguration hinzugefügt. Beides gilt nur für deinen Benutzer; andere Benutzer auf der Maschine behalten ihre eigene Auswahl.

Docker

Docker braucht wohl kaum eine Einführung. Es ermöglicht dir, isolierte Container auszuführen, und Omarchy installiert alles, was für einen guten Betrieb nötig ist, einschließlich Docker selbst und Docker Compose.

Standardmäßig ist dein Benutzer nicht in der Gruppe docker. Diese Gruppe ist faktisch root ohne Passwort – alles darin kann docker run -v /:/host ausführen und die Maschine übernehmen –, sodass ein einziges bösartiges Skript oder eine Abhängigkeit, die als du ausgeführt wird, sonst nur einen Befehl von root entfernt wäre. Auf der Kommandozeile führst du Docker daher mit sudo aus (sudo docker ps, sudo docker compose up), und die grafischen Tools, die mit dem Daemon kommunizieren – die Windows VM –, fragen bei Bedarf nach einer Autorisierung. Wenn du den Komfort einer gruppenlosen Einrichtung zurückhaben möchtest und den Kompromiss verstehst, aktiviere ihn über Setup > Security > Sudoless Docker (oder führe omarchy-setup-security-sudoless-docker aus). Dadurch wirst du nach einer Warnung zur Gruppe docker hinzugefügt; dann funktionieren einfaches docker und der Alias d wieder ohne sudo.

Die gängigen Datenbanken für die lokale Entwicklung in Docker kannst du über Install > Development > Docker DB im Omarchy-Menü einrichten.

GitHub CLI

GitHub CLI ist als gh verfügbar, um vom Terminal aus mit Repositories, Issues und Pull Requests zu arbeiten. Führe gh auth login aus, um es bei der ersten Verwendung zu installieren und dich zu authentifizieren, und anschließend gh repo clone org/repo, um ein Repository zu klonen. Führe gh --help aus, um seine Befehle zu erkunden.

Für eine Terminaloberfläche für Pull Requests führe ghui aus; mise installiert es ebenfalls bei der ersten Verwendung. Lazygit ist für die Arbeit mit Git selbst vorinstalliert.