おま寿司の 楽しみ方

omasushi.yaml を置いた GitHub / GitLab の公開リポジトリです。1 皿にはこんなものが入っています：

• packages — pacman / AUR パッケージ
• omarchy — プラグイン、フォント、既定アプリ（ブラウザ・エディタ・ターミナル…）
• herdr — Herdr プラグイン
• claude — Claude Code の skills / commands
• files — dotfiles（~/.config/… へシンボリックリンク）
• hosts — ホスト名ごとの上書き

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

皿の正体はただの git リポジトリです。ルートに omasushi.yaml があれば成立し、配りたい dotfiles や Claude Code のスキルはリポジトリ内のディレクトリに置いて yaml から指します。omasushi init が同じ形を作ってくれます：

my-omakase/
├── omasushi.yaml        # required
├── files/               # dotfiles to share
│   └── kitty/kitty.conf
├── skills/              # Claude Code skills (one dir each)
│   └── my-skill/SKILL.md
└── commands/            # Claude Code commands (*.md)
    └── review.md

• omasushi.yaml — 皿の中身を書く唯一の必須ファイル。name / description はレーンでの表示に使われます。
• files/ — 配りたい dotfiles を丸ごとコピーして置く場所。yaml の files: で「リポジトリ内のパス: リンク先」を対応付けます。ディレクトリ名は自由。
• skills/ / commands/ — Claude Code の skills（サブディレクトリごと）と commands（*.md）。yaml の claude: でディレクトリ名を指定します。
• packages / omarchy / herdr はディレクトリ不要で、yaml に名前や URL を書くだけです。
• hosts: — ホスト名ごとの上書き（GPU ドライバやモニタ配置など、そのマシン固有のもの）。

# omasushi.yaml
name: my-setup
description: short blurb shown on the belt
packages:
  pacman: [kitty, neovim]
  aur: [udev-gothic-nf]
omarchy:
  font: "UDEV Gothic NF"
  defaults: { editor: nvim, terminal: kitty }
  plugins:
    - url: https://github.com/owner/plugin.git
      enable: true
herdr:
  plugins:
    - source: owner/repo
claude:
  skills: skills
  commands: commands
files:
  files/kitty/kitty.conf: ~/.config/kitty/kitty.conf
hosts:
  laptop:
    packages: { pacman: [nvidia] }

大きな設定は機能ごとに分割できます。ルートの omasushi.yaml に parts: で各 part を直接書くか、サブディレクトリ名を並べてそれぞれに omasushi.yaml を置きます。レーンには 1 皿として流れ、中身は各 part の和集合になります。詳細ページでは part ごとに omasushi use owner/repo/<part> で必要な部分だけ取れます。

# omasushi.yaml (root) — parts written in place
name: my-setup
parts:
  kitty:
    files: { files/kitty/kitty.conf: ~/.config/kitty/kitty.conf }
  herdr:
    herdr: { plugins: [{ source: owner/repo }] }

# or one directory per part, each with its own omasushi.yaml
parts: [herdr, kitty]

# take just one part:
omasushi use owner/repo/kitty

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

ネタと皿の色は人気（スター×3 ＋ 取られた数×2 ＋ 閲覧÷10）で自動的に決まります。かっぱ巻き → 玉子 → えび → サーモン → まぐろ → いくら → 大トロ の順に出世します。値段は雰囲気で、お会計は常に 0 円です。

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

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

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

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

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

Q. Omarchy 以外でも使える？

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

Q. ログインは必要？

A. 不要です。閲覧・取る・再取得・登録すべてアカウントなしでできます。