AI とコーディング Agent

Omarchy は AI コーディング Agent をファーストクラス市民として扱いますが、特定ツールを押し付けることはありません。代わりに、すべての主要なコーディング Agent CLI が遅延読み込みランチャーとして最初から組み込まれています。ランチャーは ~/.local/bin/ 内の mise で管理された軽量スタブであり、実際に初めて実行するまでダウンロードは行われません。コマンドを入力してプロンプトに従って認証するだけです：

他の CLI を同様にラップしたい場合は、omarchy-mise-install <package> [command-name] を実行します。これらのスタブは、omarchy update（または mup エイリアス）を実行した際に mise が管理する他のすべてと一緒に最新状態に保たれます。

デフォルト Agent

omarchy default agent <name> を実行するか、Omarchy メニュー（Super + Space）の Setup > Defaults > Agent からデフォルト Agent を選択できます。その Agent がまだインストールされていない場合は、選択時に自動的にインストールされます。初回セットアップ時には、通知で選択を促されます。

選択後は、Super + Shift + Ctrl + A を押すだけで専用ターミナルウィンドウでデフォルト Agent が起動します（未選択の場合はピッカーが開きます）。また、omarchy agent prompt "Review this project" のように直接タスクを指定して起動することも可能です。この方法で起動された Agent は、それぞれの確認スキップ（don't-stop-to-ask）モードで動作するため、自律的に処理を進める点にご留意ください！また、ホームディレクトリ全体への信頼権限を避けるため、$HOME から起動した場合は自動的に ~/Work を作業ディレクトリとして開始します。

ターミナル用のショートカットも用意されています：カレントターミナル内で a を入力するとデフォルト Agent が起動し、c、cx、cy はそれぞれ OpenCode、Claude Code、Codex を直接起動します（こちらも自動承認モード）。テーマの変更も Agent に自動同期されます：Claude Code、Pi、OpenCode は、Omarchy テーマを切り替えると自動的に配色が同期されます。

バーの Agent 監視パネル

マシン上で AI コーディングツールの使用が初めて検出されると、トップバーに Agent アイコンが表示されます（それまでは邪魔にならないよう非表示です）。パネルではすべてのサブスクリプションを一元的に追跡できます：プラン、5 時間セッションや週間制限の使用率（または前払い残高）、日別およびモデル別のトークン使用量を確認できます。Claude Code、Codex、Fireworks が最初からサポートされています。

バーアイコンを左クリックするとパネルが開き、右クリックするとデフォルト Agent が起動します。使用履歴は omarchy agent usage-update によって 15 分ごとに自動更新され、同期フォルダを介して他のマシンの使用量と統合することも可能です。詳細は $OMARCHY_PATH/shell/plugins/agents/ の README を参照してください。

プロセスクラッシュの自動診断

Omarchy は systemd-coredump によるプロセスのクラッシュを常時監視しています。プログラムがセグフォ（Segmentation Fault）を起こすと「Process crashed」という通知が表示されます。これをクリックすると、Omarchy の diagnose-crash スキルと共にクラッシュ情報がデフォルト Agent に渡され、コアダンプから事実を特定して上流へ報告すべき問題かを Agent が判断します。coredumpctl list から PID を取得して omarchy agent crash <pid> で手動実行することも可能です。

クラッシュ監視はデフォルトでオンになっています。Trigger > Toggle > Crash Capture（または omarchy toggle crash-capture）でオフにすると通知が停止しますが、手動での omarchy agent crash <pid> は引き続き利用可能です。

デスクトップアプリ

Install > AI メニューには、ChatGPT 公式デスクトップアプリや、xAI モデルと対話できる Grok Bot などのグラフィカルな AI アプリも用意されています。

ローカル LLM

Omarchy ではローカル LLM モデルを実行する方法として LM Studio と Ollama の 2 つを推奨しています。LM Studio はオープンウェイトモデルの検索、インストール、実行を行うための優れた GUI インターフェースを提供します。Ollama は同様の操作を CLI で行えます。ローカルモデルが初めての方は LM Studio から始めることをお勧めします。どちらも Omarchy メニューの Install > AI からインストールできます。

Omarchy Agent スキル

Agent スキル（Skill）は、AI が特定のツールを適切な方法で使用できるように支援するものです。Omarchy には Hyprland の設定変更、トップバーの調整、さらにはゼロからのテーマ作成など、システムをカスタマイズするための公式スキルが同梱されています。Claude Code（~/.claude/skills）、Codex（~/.codex/skills）、Pi（~/.pi/agent/skills）、Antigravity（~/.gemini/config/skills）、および汎用の ~/.agents/skills にシンボリックリンクされているため、主要なハーネスから自動的に認識されます。

ただし、このスキルは実験的なものとして扱ってください。モデルによって挙動が異なる場合があります。まずは Plan モードで実行し、Agent がどのような変更を行おうとしているかを確認することをお勧めします。万が一設定が乱れた場合は、変更をロールバックするか、ターミナルで omarchy reinstall configs を実行して初期設定に復元してください。