Manuel
Outils de développement
Éditeurs alternatifs
Omarchy est livré avec Neovim par défaut, mais si vous voulez quelque chose d’un peu plus grand public et familier, vous pouvez ouvrir le menu Omarchy (Super + Space) et consulter les options sous Install > Editor. Nous avons VSCode, Cursor, Zed, Sublime Text, Helix, Vim et Emacs listés là. Si vous ne trouvez pas ce que vous cherchez, allez voir Install > Package, et vérifiez si ce n’est pas dans un paquet Arch (et si ce n’est pas le cas, essayez Install > AUR pour vérifier dans l’AUR).
L’éditeur vi d’origine est aussi disponible d’emblée. Exécutez vi filename pour modifier un fichier dans le terminal.
La correspondance des thèmes est proposée pour VSCode, Cursor, VSCodium et Helix.
Vous pouvez définir l’éditeur par défaut pour tout le système sous Setup > Defaults > Editor.
Environnement
Omarchy permet de configurer tout un tas d’environnements de développement via la section Install > Development du menu Omarchy (Super + Space). Vous y trouverez bien sûr Ruby on Rails, mais aussi les trois principaux runtimes pour JavaScript (Node.js, Bun, Deno), ainsi que des frameworks PHP populaires comme Laravel et Symfony. Ah, et il y a aussi Go, Rust, Python, Java, Elixir (avec Phoenix), .NET, OCaml, Zig, Clojure et Scala. C’est un très large choix !
La majorité de ces environnements sont gérés par Mise. C’est un outil qui vous permet d’installer et d’exécuter plusieurs versions d’un langage de programmation sur la même machine. C’est comme rbenv ou rvm pour Ruby ou virtualenv pour Python, mais il fonctionne pour tout un tas d’environnements différents.
Pour installer, disons, Ruby, vous exécuteriez mise use -g ruby, ce qui installera Ruby et le définira comme valeur par défaut globale. Ou, si votre projet a un fichier .ruby-version, vous pouvez simplement exécuter mise i à la racine de ce projet.
Outils CLI préinstallés
Omarchy rend des outils comme gh, uv, et la plupart des agents de code disponibles via l’installation paresseuse de mise. La première fois que vous en exécutez un, mise l’installe. Les exécutions suivantes réutilisent la version installée ; elles ne vérifient pas s’il y a une mise à jour à chaque lancement.
Vous pouvez aussi consulter les valeurs par défaut ou les installer à l’avance :
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
Exécutez omarchy update pour mettre à jour les outils installés avec le reste d’Omarchy. L’alias mup met à jour uniquement les outils gérés par mise. Pour ajouter un autre outil à votre propre configuration, utilisez mise use -g <tool>.
La configuration de Python installe aussi uv via mise. Retirer l’environnement de développement Python laisse uv disponible comme outil indépendant.
Utiliser votre propre installation
Les commandes de mise passent avant ~/.local/bin sur PATH, donc un outil que vous avez installé vous-même, par exemple avec l’installeur propre à Claude Code ou à Cursor, exécute quand même la copie de mise. Les applications lancées depuis le bureau trouvent aussi les commandes de mise avant les paquets système, donc une application qui exécute gh récupère la copie de mise même si vous avez installé github-cli avec pacman, et mise installe cette copie la première fois. Pour utiliser la vôtre à la place, désactivez la copie de mise dans ~/.config/mise/config.toml. Par exemple, si vous avez installé Cursor CLI vous-même :
[settings]
disable_tools = ["cursor-agent"]
Si vous avez déjà une table [settings], ajoutez l’entrée là ; étendez une liste disable_tools existante plutôt que de la remplacer. Assurez-vous que votre installation est sur PATH. Utilisez le nom d’outil mise, qui peut différer de sa commande : oh-my-pi fournit omp, par exemple. Le lanceur de l’agent par défaut préfère aussi un Cursor ou Muse installé par l’utilisateur dans ~/.local/bin.
Supprimer et restaurer les valeurs par défaut
Remove Preinstalls fait ignorer par mise les déclarations d’outils d’Omarchy pour votre utilisateur, en les ajoutant à ignored_config_paths dans ~/.config/mise/miserc.toml. Restore Preinstalls retire à nouveau cette ligne. Les outils que vous déclarez vous-même, dans votre propre configuration ou dans le mise.toml d’un projet, continuent de fonctionner dans les deux cas. Si vous choisissez un agent par défaut ou configurez Python après avoir retiré les préinstallations, cet outil est ajouté à votre propre configuration. Les deux s’appliquent uniquement à votre utilisateur ; les autres utilisateurs de la machine gardent leur propre choix.
Docker
Docker n’a guère besoin d’être présenté. Il vous permet d’exécuter des conteneurs isolés, et Omarchy installe tout ce qu’il faut pour bien l’exécuter, y compris Docker lui-même et Docker Compose.
Par défaut, votre utilisateur n’est pas dans le groupe docker. Ce groupe est en fait un accès root sans mot de passe - tout ce qui s’y trouve peut docker run -v /:/host et prendre le contrôle de la machine - donc un seul script ou une seule dépendance malveillant exécuté sous votre identité serait sinon à une commande de l’accès root. Donc, en ligne de commande, vous exécutez Docker avec sudo (sudo docker ps, sudo docker compose up), et les outils graphiques qui parlent au daemon - la VM Windows - demandent une autorisation quand ils en ont besoin. Si vous voulez retrouver la commodité d’une configuration sans groupe et que vous comprenez le compromis, activez-la depuis Setup > Security > Sudoless Docker (ou exécutez omarchy-setup-security-sudoless-docker), ce qui vous ajoute au groupe docker après un avertissement ; ensuite, docker tout court et l’alias d fonctionnent à nouveau sans sudo.
Vous pouvez configurer les bases de données courantes pour le développement local dans Docker en utilisant Install > Development > Docker DB dans le menu Omarchy.
GitHub CLI
GitHub CLI est disponible sous le nom gh pour travailler avec les dépôts, les issues et les pull requests depuis le terminal. Exécutez gh auth login pour l’installer lors de la première utilisation et vous authentifier, puis gh repo clone org/repo pour cloner un dépôt. Exécutez gh --help pour explorer ses commandes.
Pour une interface terminal pour les pull requests, exécutez ghui ; mise l’installe aussi lors de la première utilisation. Lazygit est préinstallé pour travailler avec Git lui-même.