Saltar para o conteúdo
Chapters
  1. Bem-vindo ao Omarchy!
  2. Primeiros Passos
  3. Vindo do Mac ou do Windows
  4. Navegação
  5. A Barra Superior
  6. Temas
  7. Atalhos de teclado
  8. Área de Transferência Unificada e Histórico
  9. Lembretes
  10. Avisos
  11. Extração de texto e ditado
  12. Capturas de ecrã e gravação
  13. Alternâncias, Inatividade e a Proteção de Ecrã
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. IA
  18. Ferramentas de Desenvolvimento
  19. Ferramentas de shell
  20. Funções de shell
  21. TUIs
  22. GUIs
  23. Navegadores
  24. Aplicações/serviços comerciais
  25. Aplicações Web
  26. Jogos
  27. Preencher PDF
  28. VM Windows
  29. Outros pacotes
  30. Atualizações
  31. Dotfiles
  32. Plugins da shell
  33. Monitores
  34. Teclado, Rato, Trackpad
  35. Rede
  36. Suspensão do sistema
  37. Autenticação por hardware
  38. Tipos de Letra
  39. Fundos
  40. Linha de comandos
  41. Branding
  42. Ajustes comuns
  43. Criar o seu próprio tema
  44. Suporte para Mac
  45. Resolução de problemas
  46. Perguntas frequentes
  47. Instantâneos do sistema
  48. Segurança
  49. Omarchy em...
  50. Instalação em Arranque Duplo
  51. Instalações não assistidas

Manual

Ferramentas de Desenvolvimento

Editores Alternativos

O Omarchy vem com o Neovim por predefinição, mas se quiser algo um pouco mais convencional e familiar, pode abrir o Menu Omarchy (Super + Space) e ver as opções em Instalar > Editor. Temos VSCode, Cursor, Zed, Sublime Text, Helix, Vim e Emacs listados aí. Se não encontrar o que procura, veja Instalar > Pacote e verifique se não está num pacote Arch (e, se não estiver, experimente Instalar > AUR para verificar o AUR).

O editor vi original também está disponível de imediato. Execute vi filename para editar um ficheiro no terminal.

A correspondência de temas está disponível para VSCode, Cursor, VSCodium e Helix.

Pode definir o editor predefinido para todo o sistema em Setup > Defaults > Editor.

Ambiente

O Omarchy permite configurar uma grande variedade de ambientes de desenvolvimento através da secção Instalar > Desenvolvimento do Menu Omarchy (Super + Space). É claro que vai encontrar Ruby on Rails, mas também os três principais ambientes de execução para JavaScript (Node.js, Bun, Deno), bem como frameworks PHP populares como Laravel e Symfony. Ah, e também há Go, Rust, Python, Java, Elixir (com Phoenix), .NET, OCaml, Zig, Clojure e Scala. É uma seleção muito ampla!

A maioria destes ambientes é gerida 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 uma série de ambientes diferentes.

Para instalar, por exemplo, Ruby, execute mise use -g ruby, o que instala o Ruby e o define como predefinição global. Ou, se o seu projeto tiver um ficheiro .ruby-version, basta 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 programação através da instalação lazy do mise. Na primeira vez que executa uma delas, o mise instala-a. As execuções posteriores reutilizam a versão instalada; não verificam se há uma atualização em cada arranque.

Também pode inspecionar as predefinições ou instalá-las antecipadamente:

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 juntamente com o resto do Omarchy. O alias mup atualiza apenas as ferramentas geridas pelo mise. Para adicionar outra ferramenta à sua própria configuração, utilize mise use -g <tool>.

A configuração do Python também instala o uv através do mise. Remover o ambiente de desenvolvimento Python mantém o uv disponível como ferramenta independente.

Utilizar a sua própria instalação

Os comandos do mise vêm antes de ~/.local/bin no PATH, pelo que uma ferramenta que tenha instalado por si, por exemplo com o instalador do Claude Code ou do Cursor, continua a executar a cópia do mise. As aplicações lançadas a partir do ambiente de trabalho também encontram os comandos do mise antes dos pacotes do sistema, pelo que uma aplicação que execute gh obtém a cópia do mise mesmo que tenha instalado github-cli com o pacman, e o mise instala essa cópia na primeira vez. Para utilizar a sua, desative a cópia do mise em ~/.config/mise/config.toml. Por exemplo, se instalou o Cursor CLI por si:

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

Se já tiver uma tabela [settings], adicione a entrada aí; estenda uma lista disable_tools existente em vez de a substituir. Certifique-se de que a sua instalação está no PATH. Utilize o nome da ferramenta do mise, que pode ser diferente do seu comando: o oh-my-pi fornece omp, por exemplo. O lançador do agente predefinido também prefere um Cursor ou Muse instalado pelo utilizador em ~/.local/bin.

Remover e restaurar predefinições

Remover Pré-instalações faz com que o mise ignore as declarações de ferramentas do Omarchy para o seu utilizador, adicionando-as a ignored_config_paths em ~/.config/mise/miserc.toml. Restaurar Pré-instalações remove novamente essa linha. As ferramentas que declarar por si, na sua própria configuração ou num mise.toml de um projeto, continuam a funcionar em qualquer dos casos. Se escolher um agente predefinido 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 utilizador; os outros utilizadores na máquina mantêm a sua própria escolha.

Docker

O Docker dispensa apresentações. Permite executar contentores isolados, e o Omarchy instala tudo o que é necessário para o executar bem, incluindo o próprio Docker e o Docker Compose.

Por predefinição, o seu utilizador não está no grupo docker. Esse grupo é, na prática, root sem palavra-passe - qualquer coisa nele pode executar docker run -v /:/host e tomar conta da máquina - , pelo que um único script ou dependência maliciosa a ser executado como o seu utilizador ficaria, de outra forma, a um comando de distância de root. Assim, na linha de comandos, executa o Docker com sudo (sudo docker ps, sudo docker compose up), e as ferramentas gráficas que comunicam com o daemon - a VM Windows - pedem autorização quando precisam dela. Se quiser recuperar a comodidade de uma configuração sem grupos e compreender o compromisso, ative-a em Configuração > Segurança > Docker sem sudo (ou execute omarchy-setup-security-sudoless-docker), que o adiciona ao grupo docker depois de um aviso; depois disso, o docker simples e o alias d voltam a funcionar sem sudo.

Pode configurar as bases de dados comuns para desenvolvimento local no Docker através de Instalar > Desenvolvimento > Docker DB no menu 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 o instalar na primeira utilização e autenticar-se, e depois gh repo clone org/repo para clonar um repositório. Execute gh --help para explorar os seus comandos.

Para uma interface de terminal para pull requests, execute ghui; o mise também o instala na primeira utilização. O Lazygit vem pré-instalado para trabalhar com o próprio Git.