Liigu sisu juurde
Chapters
  1. Tere tulemast Omarchysse!
  2. Alustamine
  3. Macist või Windowsist tulles
  4. Navigeerimine
  5. Ülariba
  6. Teemad
  7. Kiirklahvid
  8. Ühtne lõikelaud ja ajalugu
  9. Meeldetuletused
  10. Teated
  11. Teksti eraldamine ja dikteerimine
  12. Ekraanipildid ja salvestamine
  13. Lülitid, jõudeolek ja ekraanisäästja
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Arendustööriistad
  19. Kesta tööriistad
  20. Kesta funktsioonid
  21. TUIs
  22. GUI-d
  23. Brauserid
  24. Ärirakendused/-teenused
  25. Veebirakendused
  26. Mängimine
  27. PDF-ide täitmine
  28. Windowsi virtuaalmasin
  29. Muud paketid
  30. Uuendused
  31. Dotfile'id
  32. Kesta pistikprogrammid
  33. Monitorid
  34. Klaviatuur, hiir ja puuteplaat
  35. Võrk
  36. Süsteemi unerežiim
  37. Riistvara autentimine
  38. Fondid
  39. Taustapildid
  40. Viip
  41. Bränding
  42. Levinud kohandused
  43. Oma teema loomine
  44. Maci tugi
  45. Tõrkeotsing
  46. KKK
  47. Süsteemi hetktõmmised
  48. Turvalisus
  49. Omarchy ... peal
  50. Kahekordse alglaadimisega paigaldus
  51. Järelevalveta paigaldused

Käsiraamat

Arendustööriistad

Alternatiivsed redaktorid

Omarchy tuleb vaikimisi koos Neovimiga, aga kui soovid midagi tavapärasemat ja tuttavamat, saad käivitada Omarchy menüü (Super + Space) ja vaadata valikuid jaotises Install > Editor. Seal on loetletud VSCode, Cursor, Zed, Sublime Text, Helix, Vim ja Emacs. Kui sa ei leia seda, mida otsid, vaata jaotist Install > Package ja kontrolli, kas seda pole Arch paketina (ja kui ei ole, proovi jaotist Install > AUR, et kontrollida AURi).

Algne vi redaktor on samuti kohe karbist võttes saadaval. Faili terminalis muutmiseks käivita vi filename.

Teemade sobitamist pakutakse VSCode, Cursor, VSCodium ja Helix jaoks.

Süsteemiülese vaikimisi redaktori saad määrata jaotises Setup > Defaults > Editor.

Keskkond

Omarchy toetab tervet hulka arenduskeskkondi Omarchy menüü (Super + Space) jaotise Install > Development kaudu. Sealt leiad muidugi Ruby on Railsi, aga ka kõik kolm peamist JavaScripti käituskeskkonda (Node.js, Bun, Deno) ning populaarsed PHP raamistikud nagu Laravel ja Symfony. Ah jaa, seal on ka Go, Rust, Python, Java, Elixir (koos Phoenixiga), .NET, OCaml, Zig, Clojure ja Scala. See on väga lai valik!

Enamikku neist keskkondadest haldab Mise. See on tööriist, mis võimaldab sul samasse masinasse installida ja seal käitada programmeerimiskeele mitut versiooni. See on nagu rbenv või rvm Ruby jaoks või virtualenv Pythoni jaoks, aga see töötab paljude erinevate keskkondadega.

Näiteks Ruby installimiseks käivitaksid käsu mise use -g ruby, mis nii installib Ruby kui ka määrab selle globaalseks vaikeseadeks. Või kui sinu projektil on .ruby-version fail, saad selle projekti juurkaustas lihtsalt käivitada käsu mise i.

Eelinstallitud CLI tööriistad

Omarchy teeb tööriistad nagu gh, uv ja enamiku kodeerimisagentidest kättesaadavaks mise laiska installimise kaudu. Esimesel korral, kui mõne neist käivitad, installib mise selle. Hilisemad käivitused kasutavad installitud versiooni uuesti; need ei kontrolli iga käivituse korral värskendust.

Saad vaikeväärtusi ka kontrollida või need ette ära installida:

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

Installitud tööriistade värskendamiseks koos ülejäänud Omarchyga käivita omarchy update. Alias mup värskendab ainult mise hallatavaid tööriistu. Teise tööriista lisamiseks oma konfiguratsiooni kasuta käsku mise use -g <tool>.

Pythoni seadistus installib mise kaudu ka tööriista uv. Pythoni arenduskeskkonna eemaldamine jätab tööriista uv sõltumatu tööriistana alles.

Oma installatsiooni kasutamine

Mise käsud asuvad PATHis enne kausta ~/.local/bin, nii et tööriist, mille oled ise installinud, näiteks Claude Code’i või Cursori enda installeriga, käivitab ikkagi mise koopia. Töölaualt käivitatud rakendused leiavad mise käsud samuti enne süsteemipakette, nii et rakendus, mis käivitab käsu gh, saab mise koopia isegi siis, kui installisid paketi github-cli pacmaniga, ja mise installib selle koopia esimesel korral. Oma koopia kasutamiseks keela selle asemel mise koopia failis ~/.config/mise/config.toml. Näiteks kui installisid Cursor CLI ise:

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

Kui sul on juba tabel [settings], lisa kirje sinna; laienda olemasolevat loendit disable_tools, selle asendamise asemel. Veendu, et sinu installatsioon on PATHis. Kasuta mise tööriista nime, mis võib selle käsust erineda: näiteks oh-my-pi pakub käsku omp. Vaikeagendi käivitaja eelistab samuti kasutaja installitud Cursori või Claude Code’i kaustas ~/.local/bin.

Vaikeväärtuste eemaldamine ja taastamine

Remove Preinstalls paneb mise sinu kasutaja puhul Omarchy tööriistadeklaratsioonid vahele jätma, lisades need failis ~/.config/mise/miserc.toml kirjele ignored_config_paths. Restore Preinstalls eemaldab selle rea uuesti. Tööriistad, mille oled ise deklareerinud, oma konfiguratsioonis või projekti failis mise.toml, töötavad edasi mõlemal juhul. Kui valid pärast eelinstallide eemaldamist vaikeagendi või seadistad Pythoni, lisatakse see tööriist sinu enda konfiguratsiooni. Mõlemad kehtivad ainult sinu kasutajale; teised masina kasutajad säilitavad oma valiku.

Docker

Docker ei vaja peaaegu mingit tutvustust. See võimaldab sul käitada isoleeritud konteinereid ja Omarchy installib kõik, mis on selle heaks toimimiseks vajalik, sealhulgas Dockeri enda ja Docker Compose’i.

Vaikimisi sinu kasutaja ei kuulu gruppi docker. See grupp on sisuliselt paroolita root - igaüks selles saab käivitada käsu docker run -v /:/host ja masina üle võtta - , nii et üksainus sinu nimel töötav pahatahtlik skript või sõltuvus oleks muidu rootist vaid ühe käsu kaugusel. Nii et käsureal käitad Dockerit käsuga sudo (sudo docker ps, sudo docker compose up) ja graafilised tööriistad, mis deemoniga suhtlevad - Windows VM - , küsivad vajadusel autoriseerimist. Kui soovid grupita seadistuse mugavust tagasi ja mõistad kompromissi, luba see jaotisest Setup > Security > Sudoless Docker (või käivita omarchy-setup-security-sudoless-docker), mis lisab sind pärast hoiatust gruppi docker; siis töötavad tavaline docker ja alias d jälle ilma käsuta sudo.

Levinud andmebaasid kohalikuks arenduseks saad Dockeris seadistada Omarchy menüü jaotise Install > Development > Docker DB kaudu.

GitHub CLI

GitHub CLI on saadaval käsuna gh hoidlate, issue’de ja pull requestidega terminalist töötamiseks. Käivita gh auth login, et see esimesel kasutuskorral installida ja autentida, seejärel käivita hoidla kloonimiseks gh repo clone org/repo. Selle käskude uurimiseks käivita gh --help.

Pull requestide terminaliliidese jaoks käivita ghui; mise installib ka selle esimesel kasutuskorral. Lazygit on Giti endaga töötamiseks eelinstallitud.