おま寿司の 楽しみ方

機能ひとつ分の omasushi.yaml とそのファイルを「パック」として並べた GitHub / GitLab の公開リポジトリです。1 パックにはこんなものが入っています：

• packages — pacman / AUR パッケージ
• omarchy — プラグイン、フォント、既定アプリ（ブラウザ・エディタ・ターミナル…）
• herdr — Herdr プラグイン
• agent / claude — エージェントの skills / commands（Claude Code、Codex、…）
• hypr — hyprland のスニペット（他のパックのと並んで読み込まれます）
• files — dotfiles（~/.config/… へシンボリックリンク）
• use — 前提にする他のパック

皿の詳細ページで中身をカテゴリごとに確認でき、omasushi.yaml の原文も見られます。

皿の正体はただの git リポジトリです。omasushi.yaml を持つサブディレクトリがそれぞれ 1 パック。ルートの omasushi.yaml はリポジトリの名前を書くだけで、無くても構いません（サブディレクトリが無ければ、リポジトリ自体が 1 パック）。omasushi init が同じ形を作ってくれます：

my-packs/
├── omasushi.yaml            # names the repository — nothing else
├── kitty/                   # one pack
│   ├── omasushi.yaml
│   └── files/kitty/kitty.conf
└── herdr/                   # another
    ├── omasushi.yaml
    ├── hypr/herdr.lua       # a hyprland snippet
    ├── files/herdr/config.toml
    └── skills/my-skill/SKILL.md

• <pack>/omasushi.yaml — パックの中身を書く唯一の必須ファイル。description はレーンでの表示に使われます。
• <pack>/files/ — 配りたい dotfiles を丸ごとコピーして置く場所。yaml の files: で「パック内のパス: リンク先」を対応付けます。
• <pack>/hypr/*.lua — hyprland のスニペット。yaml の hypr: で指すと ~/.config/hypr/omasushi.d/ に置かれ、他のパックのと一緒に読み込まれます。bindings.lua を丸ごと持つ必要はありません。
• <pack>/skills/ と commands/ — エージェントの skills（サブディレクトリごと）と commands（*.md）。yaml の agent: でディレクトリ名を指定します。
• packages / omarchy / herdr はディレクトリ不要で、yaml に名前や URL を書くだけです。
• use: — このパックが前提にするパック。同じリポジトリの兄弟は ../fonts と書けます。

# herdr/omasushi.yaml — one pack
description: herdr with tmux-style keys, its plugins, and the bar widget
use: [../fonts]                # a sibling pack this one needs
packages:
  pacman: [fcitx5, jq]
omarchy:
  plugins:
    - url: https://github.com/fabean/omarchy-herdr.git
      enable: true
herdr:
  plugins:
    - source: owner/repo
agent:
  skills: skills
  commands: commands
hypr: hypr/herdr.lua           # loaded alongside other packs' snippets
files:
  files/herdr/config.toml: ~/.config/herdr/config.toml

パックは機能ひとつ分の大きさにしておきます。レーンにはリポジトリが 1 皿として流れ、中身は各パックの和集合。詳細ページではパックごとに omasushi use owner/repo/<pack> で必要なものだけ取れます。半分だけ欲しくなるパックは、二つに割るべきだったパックです。

# omasushi.yaml (root) — only names the repository
name: my-packs
description: what these packs are about

# take just one pack:
omasushi use owner/my-packs/kitty
# or all of them:
omasushi use owner/my-packs

トークンや鍵など秘密のものは files: に入れないでください。皿は公開リポジトリが前提です。

ネタは皿ごとに決まった持ちネタで、レーンに流したときに配られます。人気とは無関係です。皿の色と値段は人気（スター×3 ＋ 取られた数×2 ＋ 閲覧÷10）で自動的に決まり、白皿 → 金皿 → 赤皿 → 青皿 → 特上皿 の順に出世します。値段は雰囲気で、お会計は常に 0 円です。

詳細ページの「再取得」を押すと、誰でも omasushi.yaml を読み直せます（omasushi update は別途各自で）。リポジトリから omasushi.yaml が消えたり private になったりして 3 回連続で再取得に失敗した皿はレーンから下がり、再登録または再取得が成功すれば戻ります。

Q. 皿を取ったら勝手にインストールされる？

A. いいえ。「取る」「お会計」はコマンドを組み立てるだけです。実際に動くのはあなたが端末で sync を実行したときだけで、その前に diff で内容を確認できます。

Q. 自分の設定が消えたりしない？

A. omasushi は何も削除しません。dotfiles を置き換えるときは元のファイルを .bak として残します。

Q. Omarchy 以外でも使える？

A. Arch 系 + Omarchy（omarchy / yay コマンド）が前提です。それ以外では diff は動きますが sync の多くは失敗します。

Q. ログインは必要？

A. 閲覧・取る・再取得はアカウントなしでできます。皿を流すときだけ、提出 issue を立てるのに GitHub アカウントを使います。