本文へスキップ
Chapters
  1. Omarchy へようこそ!
  2. はじめに
  3. MacやWindowsから乗り換えたら
  4. ナビゲーション
  5. トップバー
  6. テーマ
  7. ホットキー
  8. 統一クリップボードと履歴
  9. リマインダー
  10. 通知
  11. テキスト抽出とディクテーション
  12. スクリーンショットと録画
  13. トグル、アイドルとスクリーンセーバー
  14. Omarchy CLI
  15. ターミナル
  16. Neovim
  17. AI
  18. 開発ツール
  19. シェルツール
  20. シェル関数
  21. TUIs
  22. GUI
  23. ブラウザ
  24. 商用アプリ/サービス
  25. Web アプリ
  26. ゲーミング
  27. PDF への記入
  28. Windows VM
  29. その他のパッケージ
  30. アップデート
  31. Dotfiles
  32. シェルプラグイン
  33. モニター
  34. キーボード、マウス、トラックパッド
  35. ネットワーキング
  36. システムスリープ
  37. ハードウェア認証
  38. フォント
  39. 背景
  40. プロンプト
  41. ブランディング
  42. よくある調整
  43. 独自のテーマを作る
  44. Mac サポート
  45. トラブルシューティング
  46. FAQ
  47. システムスナップショット
  48. セキュリティ
  49. Omarchy on...
  50. デュアルブートインストール
  51. 無人インストール

マニュアル

開発ツール

別のエディタ

Omarchy はデフォルトで Neovim を搭載していますが、もう少し主流で馴染みのあるものがよければ、Omarchy Menu(Super + Space)を開いて、Install > Editor の下にある選択肢を確認できます。VSCode、Cursor、Zed、Sublime Text、Helix、Vim、Emacs がそこに並んでいます。探しているものが見つからなければ、Install > Package を確認して、Arch パッケージにないか見てみてください(それでもなければ、Install > AUR で AUR を確認してください)。

元の vi エディタも最初から使えます。ターミナルでファイルを編集するには vi filename を実行してください。

テーマのマッチングは VSCode、Cursor、VSCodium、Helix に対応しています。

システム全体のデフォルトエディタは Setup > Defaults > Editor で設定できます。

環境

Omarchy は、Omarchy Menu(Super + Space)の Install > Development セクションから、数多くの開発環境のセットアップに対応しています。もちろん Ruby on Rails もありますが、JavaScript の主要な 3 つのランタイム(Node.js、Bun、Deno)も、Laravel や Symfony といった人気の PHP フレームワークもあります。ああ、それに Go、Rust、Python、Java、Elixir(Phoenix 付き)、.NET、OCaml、Zig、Clojure、Scala もあります。実に幅広いラインナップです!

これらの環境の大半は Mise で管理されています。これは、同じマシン上にプログラミング言語の複数のバージョンをインストールして実行できるツールです。Ruby 向けの rbenv や rvm、Python 向けの virtualenv のようなものですが、さまざまな環境に対応しています。

たとえば Ruby をインストールするには mise use -g ruby を実行します。これで Ruby のインストールと、グローバルデフォルトとしての設定の両方が行われます。あるいは、プロジェクトに .ruby-version ファイルがある場合は、そのプロジェクトのルートで mise i を実行するだけです。

プリインストールされた CLI ツール

Omarchy は、gh、uv、そして大半のコーディングエージェントといったツールを、mise の遅延インストールを通じて利用できるようにしています。初めて実行したときに、mise がそれをインストールします。2 回目以降の実行ではインストール済みのバージョンを再利用します。起動のたびにアップデートを確認することはありません。

デフォルトを確認したり、事前にインストールしたりもできます。

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

インストール済みのツールを Omarchy の他の部分と一緒にアップデートするには omarchy update を実行してください。mup エイリアスは mise で管理されているツールだけをアップデートします。自分の設定に別のツールを追加するには、mise use -g <tool> を使ってください。

Python のセットアップでは、mise を通じて uv もインストールされます。Python 開発環境を削除しても、uv は独立したツールとして引き続き使えます。

自分でインストールしたものを使う

mise のコマンドは PATH 上で ~/.local/bin より前に来るため、たとえば Claude Code や Cursor 独自のインストーラーで自分でインストールしたツールでも、依然として mise のコピーが実行されます。デスクトップから起動したアプリも、システムパッケージより前に mise のコマンドを見つけるため、gh を実行するアプリは、pacman で github-cli をインストールしていても mise のコピーを使います。そして mise は初回にそのコピーをインストールします。代わりに自分のものを使うには、~/.config/mise/config.toml で mise のコピーを無効化してください。たとえば、Cursor CLI を自分でインストールした場合は次のようになります。

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

すでに [settings] テーブルがある場合は、そこにこのエントリを追加してください。既存の disable_tools リストがある場合は、それを置き換えるのではなく拡張してください。自分のインストールが PATH 上にあることを確認してください。mise のツール名を使ってください。これはコマンド名と異なる場合があります。たとえば、oh-my-pi は omp を提供します。デフォルトエージェントのランチャーも、~/.local/bin にユーザーがインストールした Cursor や Muse を優先します。

デフォルトの削除と復元

Remove Preinstalls を使うと、~/.config/mise/miserc.toml の ignored_config_paths に追加することで、mise があなたのユーザー向けの Omarchy のツール宣言をスキップするようになります。Restore Preinstalls を使うと、その行が再び削除されます。自分の設定やプロジェクトの mise.toml で自分で宣言したツールは、どちらの場合でも引き続き動作します。プリインストールを削除した後にデフォルトエージェントを選んだり Python をセットアップしたりすると、そのツールは自分の設定に追加されます。どちらもあなたのユーザーにのみ適用されます。マシン上の他のユーザーは、それぞれ自分の選択を維持します。

Docker

Docker は、今さら紹介するまでもないでしょう。隔離されたコンテナを実行でき、Omarchy は Docker 本体や Docker Compose など、快適に実行するために必要なものすべてをインストールします。

デフォルトでは、あなたのユーザーは docker グループに入っていません。そのグループは実質的にパスワードなしの root です。そのグループに入っているものは何でも docker run -v /:/host を実行してマシンを乗っ取ることができるため、あなたとして実行される不正なスクリプトや依存関係が 1 つあるだけで、root まであとコマンド 1 つという状態になってしまいます。そこで、コマンドラインでは Docker を sudo 付きで実行し(sudo docker ps、sudo docker compose up)、デーモンと通信するグラフィカルツール、つまり Windows VM は、必要なときに認可を求めます。グループなしのセットアップの便利さを取り戻したい方で、そのトレードオフを理解している場合は、Setup > Security > Sudoless Docker から有効化するか(あるいは omarchy-setup-security-sudoless-docker を実行するか)、警告の後にあなたを docker グループに追加できます。そうすれば、プレーンな docker と d エイリアスが再び sudo なしで動作します。

Omarchy メニューの Install > Development > Docker DB を使えば、ローカル開発向けの一般的なデータベースを Docker でセットアップできます。

GitHub CLI

GitHub CLI は、ターミナルからリポジトリ、issue、プルリクエストを扱うための gh として利用できます。初回利用時のインストールと認証を行うには gh auth login を実行し、次にリポジトリをクローンするには gh repo clone org/repo を実行してください。コマンドを調べるには gh --help を実行してください。

プルリクエスト向けのターミナルインターフェースには、ghui を実行してください。これも初回利用時に mise がインストールします。Git 自体を扱うための Lazygit はプリインストールされています。