Vai al contenuto
Chapters
  1. Benvenuto su Omarchy!
  2. Per iniziare
  3. Provenire da Mac o Windows
  4. Navigazione
  5. La barra superiore
  6. Temi
  7. Scorciatoie da tastiera
  8. Appunti unificati e cronologia
  9. Promemoria
  10. Avvisi
  11. Estrazione testo e dettatura
  12. Screenshot e registrazione
  13. Interruttori, inattività e lo screensaver
  14. Omarchy CLI
  15. Terminale
  16. Neovim
  17. IA
  18. Strumenti di sviluppo
  19. Strumenti della shell
  20. Funzioni della shell
  21. TUIs
  22. Interfacce grafiche
  23. Browser
  24. App/servizi commerciali
  25. App web
  26. Giochi
  27. Compilare i PDF
  28. VM Windows
  29. Altri pacchetti
  30. Aggiornamenti
  31. Dotfiles
  32. Plugin della shell
  33. Monitor
  34. Tastiera, Mouse, Trackpad
  35. Rete
  36. Sospensione del sistema
  37. Autenticazione hardware
  38. Font
  39. Sfondi
  40. Prompt
  41. Branding
  42. Ritocchi comuni
  43. Creare il tuo tema
  44. Supporto Mac
  45. Risoluzione dei problemi
  46. Domande frequenti
  47. Snapshot di sistema
  48. Sicurezza
  49. Omarchy su...
  50. Installazione in dual boot
  51. Installazioni senza intervento

Manuale

Strumenti di sviluppo

Editor alternativi

Omarchy include Neovim per impostazione predefinita, ma se vuoi qualcosa di un po’ più mainstream e familiare, puoi aprire il Menu di Omarchy (Super + Space) e vedere le opzioni in Install > Editor. Lì trovi VSCode, Cursor, Zed, Sublime Text, Helix, Vim ed Emacs. Se non trovi quello che cerchi, dai un’occhiata a Install > Package e verifica se non è disponibile come pacchetto Arch (e in caso contrario, prova Install > AUR per controllare nell’AUR).

Anche l’editor vi originale è disponibile fin da subito. Esegui vi filename per modificare un file nel terminale.

La corrispondenza del tema è disponibile per VSCode, Cursor, VSCodium e Helix.

Puoi impostare l’editor predefinito a livello di sistema in Setup > Defaults > Editor.

Ambiente

Omarchy supporta la configurazione di un’intera gamma di ambienti di sviluppo tramite la sezione Install > Development del Menu di Omarchy (Super + Space). Naturalmente troverai Ruby on Rails, ma anche tutti e tre i principali runtime per JavaScript (Node.js, Bun, Deno), oltre a popolari framework PHP come Laravel e Symfony. Oh, e ci sono anche Go, Rust, Python, Java, Elixir (con Phoenix), .NET, OCaml, Zig, Clojure e Scala. È una selezione davvero ampia!

La maggior parte di questi ambienti è gestita da Mise. È uno strumento che ti permette di installare ed eseguire più versioni di un linguaggio di programmazione sulla stessa macchina. È come rbenv o rvm per Ruby o virtualenv per Python, ma funziona per un sacco di ambienti diversi.

Per installare, ad esempio, Ruby, esegui mise use -g ruby, che installerà Ruby e lo imposterà come predefinito globale. Oppure, se il tuo progetto ha un file .ruby-version, puoi semplicemente eseguire mise i nella root di quel progetto.

Strumenti CLI preinstallati

Omarchy rende disponibili strumenti come gh, uv e la maggior parte degli agenti di coding tramite l’installazione lazy di mise. La prima volta che ne esegui uno, mise lo installa. Le esecuzioni successive riutilizzano la versione installata; non controllano la presenza di un aggiornamento a ogni avvio.

Puoi anche controllare i valori predefiniti o installarli in anticipo:

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

Esegui omarchy update per aggiornare gli strumenti installati insieme al resto di Omarchy. L’alias mup aggiorna solo gli strumenti gestiti da mise. Per aggiungere un altro strumento alla tua configurazione, usa mise use -g <tool>.

La configurazione di Python installa anche uv tramite mise. La rimozione dell’ambiente di sviluppo Python lascia uv disponibile come strumento indipendente.

Usare la tua installazione

I comandi di mise vengono prima di ~/.local/bin in PATH, quindi uno strumento che hai installato tu stesso, ad esempio con l’installer di Claude Code o di Cursor, continua a eseguire la copia di mise. Anche le app avviate dal desktop trovano i comandi di mise prima dei pacchetti di sistema, quindi un’app che esegue gh ottiene la copia di mise anche se hai installato github-cli con pacman, e mise installa quella copia alla prima esecuzione. Per usare invece la tua, disattiva la copia di mise in ~/.config/mise/config.toml. Ad esempio, se hai installato Cursor CLI da solo:

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

Se hai già una tabella [settings], aggiungi la voce lì; estendi un elenco disable_tools esistente invece di sostituirlo. Assicurati che la tua installazione sia in PATH. Usa il nome dello strumento mise, che può differire dal suo comando: oh-my-pi fornisce omp, ad esempio. Anche il launcher dell’agente predefinito preferisce un Cursor o Muse installato dall’utente in ~/.local/bin.

Rimozione e ripristino dei valori predefiniti

Remove Preinstalls fa sì che mise salti le dichiarazioni degli strumenti di Omarchy per il tuo utente, aggiungendole a ignored_config_paths in ~/.config/mise/miserc.toml. Restore Preinstalls rimuove di nuovo quella riga. Gli strumenti che dichiari tu stesso, nella tua configurazione o in un mise.toml di un progetto, continuano a funzionare in entrambi i casi. Se scegli un agente predefinito o configuri Python dopo aver rimosso i preinstallati, quello strumento viene aggiunto alla tua configurazione. Entrambe le opzioni si applicano solo al tuo utente; gli altri utenti sulla macchina mantengono la propria scelta.

Docker

Docker non ha certo bisogno di presentazioni. Ti permette di eseguire container isolati, e Omarchy installa tutto il necessario per farlo funzionare bene, incluso Docker stesso e Docker Compose.

Per impostazione predefinita il tuo utente non è nel gruppo docker. Quel gruppo equivale di fatto a root senza password - qualsiasi cosa ne faccia parte può eseguire docker run -v /:/host e prendere il controllo della macchina - quindi un singolo script o una singola dipendenza malevola in esecuzione con il tuo utente sarebbe altrimenti a un solo comando da root. Quindi da riga di comando esegui Docker con sudo (sudo docker ps, sudo docker compose up), e gli strumenti grafici che comunicano con il daemon - la VM Windows - chiedono l’autorizzazione quando ne hanno bisogno. Se vuoi ritrovare la comodità di una configurazione senza gruppo e capisci il compromesso, abilitala da Setup > Security > Sudoless Docker (oppure esegui omarchy-setup-security-sudoless-docker), che ti aggiunge al gruppo docker dopo un avviso; a quel punto il semplice docker e l’alias d funzionano di nuovo senza sudo.

Puoi configurare i database più comuni per lo sviluppo locale in Docker usando Install > Development > Docker DB nel menu di Omarchy.

GitHub CLI

GitHub CLI è disponibile come gh per lavorare con repository, issue e pull request dal terminale. Esegui gh auth login per installarlo al primo utilizzo e autenticarti, poi gh repo clone org/repo per clonare un repository. Esegui gh --help per esplorare i suoi comandi.

Per un’interfaccia da terminale per le pull request, esegui ghui; anche in questo caso mise lo installa al primo utilizzo. Lazygit è preinstallato per lavorare con Git stesso.