Manual
Ferramentas de Desenvolvimento
Editores Alternativos
O Omarchy vem com o Neovim por padrão, mas se você quiser algo um pouco mais popular e familiar, pode abrir o Omarchy Menu (Super + Space) e ver as opções em Install > Editor. Temos VSCode, Cursor, Zed, Sublime Text, Helix, Vim e Emacs listados lá. Se você não encontrar o que está procurando, confira Install > Package e veja se ele não está em um pacote do Arch (e, se não estiver, tente Install > AUR para verificar o AUR).
O editor vi original também está disponível de fábrica. Execute vi filename para editar um arquivo no terminal.
A correspondência de temas é oferecida para VSCode, Cursor, VSCodium e Helix.
Você pode definir o editor padrão de todo o sistema em Setup > Defaults > Editor.
Ambiente
O Omarchy permite configurar uma porção inteira de ambientes de desenvolvimento por meio da seção Install > Development do Omarchy Menu (Super + Space). Você vai encontrar, é claro, o Ruby on Rails, mas também os três principais runtimes para JavaScript (Node.js, Bun, Deno), além de frameworks PHP populares como Laravel e Symfony. Ah, e também tem Go, Rust, Python, Java, Elixir (com Phoenix), .NET, OCaml, Zig, Clojure e Scala. É uma seleção bem ampla!
A maioria desses ambientes é gerenciada pelo Mise. É uma ferramenta que permite instalar e executar várias versões de uma linguagem de programação na mesma máquina. É como o rbenv ou o rvm para Ruby ou o virtualenv para Python, mas funciona para um monte de ambientes diferentes.
Para instalar, digamos, o Ruby, você executaria mise use -g ruby, que vai instalar o Ruby e defini-lo como o padrão global. Ou, se o seu projeto tiver um arquivo .ruby-version, você pode simplesmente executar mise i na raiz desse projeto.
Ferramentas de CLI pré-instaladas
O Omarchy disponibiliza ferramentas como gh, uv e a maioria dos agentes de código por meio da instalação preguiçosa do mise. Na primeira vez que você executa uma delas, o mise a instala. As execuções posteriores reutilizam a versão instalada; elas não verificam se há uma atualização a cada inicialização.
Você também pode inspecionar os padrões ou instalá-los com antecedência:
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
Execute omarchy update para atualizar as ferramentas instaladas junto com o restante do Omarchy. O alias mup atualiza apenas as ferramentas gerenciadas pelo mise. Para adicionar outra ferramenta à sua própria configuração, use mise use -g <tool>.
A configuração do Python também instala o uv por meio do mise. Remover o ambiente de desenvolvimento Python mantém o uv disponível como uma ferramenta independente.
Usando sua própria instalação
Os comandos do mise vêm antes de ~/.local/bin no PATH, então uma ferramenta que você instalou por conta própria, por exemplo com o instalador do próprio Claude Code ou do Cursor, ainda executa a cópia do mise. Os aplicativos iniciados a partir da área de trabalho também encontram os comandos do mise antes dos pacotes do sistema, então um aplicativo que executa gh obtém a cópia do mise mesmo que você tenha instalado o github-cli com o pacman, e o mise instala essa cópia na primeira vez. Para usar a sua, desative a cópia do mise em ~/.config/mise/config.toml. Por exemplo, se você instalou o Cursor CLI por conta própria:
[settings]
disable_tools = ["cursor-agent"]
Se você já tiver uma tabela [settings], adicione a entrada lá; estenda uma lista disable_tools existente em vez de substituí-la. Certifique-se de que a sua instalação esteja no PATH. Use o nome da ferramenta do mise, que pode ser diferente do seu comando: o oh-my-pi fornece o omp, por exemplo. O inicializador do agente padrão também prefere um Cursor ou Claude instalado pelo usuário em ~/.local/bin.
Removendo e restaurando os padrões
Remove Preinstalls faz o mise ignorar as declarações de ferramentas do Omarchy para o seu usuário, adicionando-as a ignored_config_paths em ~/.config/mise/miserc.toml. Restore Preinstalls remove essa linha novamente. As ferramentas que você declara por conta própria, na sua própria configuração ou no mise.toml de um projeto, continuam funcionando de qualquer maneira. Se você escolher um agente padrão ou configurar o Python depois de remover as pré-instalações, essa ferramenta é adicionada à sua própria configuração. Ambas se aplicam apenas ao seu usuário; os outros usuários da máquina mantêm a própria escolha.
Docker
O Docker dispensa apresentações. Ele permite executar contêineres isolados, e o Omarchy instala tudo o que é necessário para executá-lo bem, incluindo o próprio Docker e o Docker Compose.
Por padrão, seu usuário não está no grupo docker. Esse grupo é, na prática, root sem senha - qualquer coisa nele pode executar docker run -v /:/host e tomar conta da máquina - , então um único script ou dependência maliciosa executado como você estaria, de outra forma, a um comando de distância do root. Então, na linha de comando, você executa o Docker com sudo (sudo docker ps, sudo docker compose up), e as ferramentas gráficas que se comunicam com o daemon - a Windows VM - pedem autorização quando precisam. Se você quiser de volta a conveniência de uma configuração sem grupo e entender o compromisso envolvido, ative-a em Setup > Security > Sudoless Docker (ou execute omarchy-setup-security-sudoless-docker), que adiciona você ao grupo docker depois de um aviso; aí o docker simples e o alias d voltam a funcionar sem sudo.
Você pode configurar os bancos de dados comuns para desenvolvimento local no Docker usando Install > Development > Docker DB no menu do Omarchy.
GitHub CLI
O GitHub CLI está disponível como gh para trabalhar com repositórios, issues e pull requests a partir do terminal. Execute gh auth login para instalá-lo no primeiro uso e se autenticar, e depois gh repo clone org/repo para clonar um repositório. Execute gh --help para explorar os comandos dele.
Para uma interface de terminal para pull requests, execute ghui; o mise também o instala no primeiro uso. O Lazygit vem pré-instalado para trabalhar com o próprio Git.