Omarchy LogoOMARCHYPULSE

Shell 補助関数

Omarchy には、日常的な作業を簡素化し、複雑なパラメータ呼び出しをカプセル化する便利な Shell 補助関数が多数組み込まれています。

ファイル圧縮と展開 (Compression)

  • compress [file/dir]: 指定したファイルまたはディレクトリから tar.gz アーカイブを作成します。
  • decompress [file.tar.gz]: tar.gz ファイルを展開します。

ドライブとストレージ管理 (Drives)

  • iso2sd [image.iso]: 指定した ISO ファイルを使用して、インタラクティブに対象ドライブを選択し、SD カードや USB メモリにブートドライブを作成します。
  • format-drive [device] [name]: ディスク全体を単一の exFAT パーティション（Windows や macOS でも利用可能）でフォーマットします。引数なしで実行すると利用可能なドライブ一覧が表示されます。実行には十分ご注意ください！

開発環境レイアウト (Dev layouts)

Tmux 用のマルチペイン開発レイアウトを即座に作成します：

  • tdl [ai]: エディタ、AI Agent、ターミナルを備えた Tmux 開発レイアウトを作成します。tdl c（opencode）や tdl cx（Claude Code）のような Agent エイリアスを使用できます。tdl c cx のように 2 つの Agent を渡して両方を起動することも可能です。
  • tds: エディタ、リアルタイム diff 監視（hunk diff --watch 経由）、ターミナル、opencode を備えた 4 分割開発スクエアを作成します。
  • tdlm [ai]: カレントディレクトリ内のすべてのサブディレクトリに対して個別に tdl ウィンドウを作成します。
  • tsl [count] [command]: すべて同じコマンドを実行するペインのグリッド（スウォーム）を作成します（AI Agent の並行稼働に最適です）。

Herdr でも同様のレイアウトが hdl、hds、hdlm、hsl として利用可能です。

Git ワークツリー (Git worktrees)

  • ga [branch]: カレントリポジトリの隣に新しい Git Worktree とブランチを作成し、即座にそのディレクトリに移動します。
  • gd: 現在の Worktree とそのブランチを削除します（実行前に確認が表示されます）。

Rsync リアルタイム同期監視 (Rsync watchers)

  • rsw [source] [destination]: ソースディレクトリに変更があるたびに自動でデスティネーションへ rsync するバックグラウンド監視プロセスを開始します。rsw ~/Work/app nyc-dev:Work/app のようにリモートホストを指定することも可能です。
  • lsw: 実行中のすべての監視プロセスを一覧表示します。
  • dsw: すべての監視プロセスを停止します。

SSH ポートフォワーディング (SSH Portforwarding)

リモートサーバーに対して、Localhost の安全なコンテキスト権限（Secure Context）を維持したまま Web 開発を行うのに最適です。

  • fip: SSH 経由でリモートホストの 1 つ以上のポートをローカルの Localhost に転送します。
  • dip: ポート転送を切断します。
  • lip: アクティブな SSH ポート転送を一覧表示します。

例えば nyc-dev というリモートマシン上でポート 3000 の開発サーバーを起動している場合、fip nyc-dev 3000 を実行すれば、localhost:3000 へのアクセスが nyc-dev:3000 に直結します。WebSocket などのテストに必要なローカルの安全なコンテキストを SSL 証明書の設定なしで即座に利用できます。

SSH 自動再接続 (SSH reconnection)

ssh コマンド自体が関数でラップされています：リモートの Tmux、Herdr、またはエディタがターミナルを使用中に接続が切断された場合、ターミナル状態を自動的にクリーンアップし、セッション切断時に自動で再接続を試行します（Ctrl-C で再試行ループを停止できます）。

出典