omasushi コマンドの使い方

omasushi use [--mine] <owner/repo[/part] | url | path>omakase を 1 皿取る（clone して登録）

owner/repo・URL・ローカルパスを受け取ります。owner/repo は分割リポジトリの全 part、owner/repo/<part> はその part だけ。何度でも重ねられ、設定がぶつかったら後から取ったほうが勝ちます。use: を書いてある皿なら、土台にしている皿も一緒に入ります。

オプション

• --mine — 自分の omakase として印を付ける（export の既定の書き込み先になります）

omasushi use polidog/omakase          # every part of the repo
omasushi use polidog/omakase/herdr    # just one part
omasushi use --mine you/my-setup      # and mark it as yours
omasushi use ./my-omakase             # a local directory

omasushi diff [--json]sync が何をするかを見る

omakase と実機を比べて、足りないパッケージ・プラグイン・リンクを並べます。マシンには一切触りません。どの皿由来かが <- のあとに出ます。

オプション

• --json — バーのウィジェットが読む機械可読な出力
• 旧名 plan も動きます

omasushi diff
omasushi diff --json | jq '.actions | length'

omasushi sync足りないものだけ入れる

diff に出た内容をそのまま実行します。呼ぶのは omarchy / herdr / yay の各コマンドで、何かをアンインストールすることはありません。dotfile を置き換えるときは、元のファイルを .bak に退避してからリンクします。途中で失敗した項目があっても残りは実行され、最後に exit 1 になります。

オプション

• 旧名 apply も動きます

omasushi diff && omasushi sync

omasushi status [--json]今どうなっているかを見る

取っている omakase とその git の状態、このマシンの設定、未適用・未記録の件数をまとめて出します。困ったらまずこれ。

オプション

• --json

omasushi status

omasushi list取っている皿の一覧

名前・git かローカルか・取得元・チェックアウト先。(mine) は自分の omakase、(via X) は X の use: で一緒に入ってきた皿です。

$ omasushi list
my-setup   git    you/my-setup      ~/.local/share/omasushi/omakases/my-setup  (mine)
herdr      git    polidog/omakase   ~/.local/share/omasushi/omakases/omakase   (via my-setup)

omasushi update皿を最新にする

登録済みの omakase を全部 git pull します。インストール済みの omasushi skill もこのとき書き直されます。取り込むのは別なので、update のあとに diff → sync してください。

omasushi update && omasushi diff

omasushi remove <name>皿を返す

その omakase を忘れます。張ったリンクは外れ、管理下の clone も消えます。パッケージは入ったままです（omasushi は何もアンインストールしません）。

omasushi remove herdr

omasushi unlink [<name>] [--dry-run]リンクだけ外す

sync が張ったシンボリックリンクを外し、.bak に退避してあった元のファイルを戻します。名前を渡すとその omakase の分だけ。.bak がないリンクは外すと何も残らないので、最後に名前が並びます。

オプション

• --dry-run — 外さずに、外すものだけ表示
• 旧名 clean も動きます

omasushi unlink --dry-run      # look first
omasushi unlink my-setup       # just this omakase
omasushi unlink                # every link

omasushi mine [<name> | none]自分の omakase を決める

export の既定の書き込み先になります。引数なしで今の設定を表示、none で解除。omasushi use --mine <repo> でも同じことができます。

omasushi mine            # what is mine right now?
omasushi mine my-setup
omasushi mine none

omasushi init [dir]omakase の雛形を作る

omasushi.yaml とコメント付きの雛形、files/ などの入れ物を作ります。ディレクトリ名を省略すると今いる場所に作ります。

omasushi init my-omakase && cd my-omakase

omasushi export [--to <omakase>] [--host <name>]今のマシンを omakase に書き出す

手で入れた AUR パッケージ・Omarchy プラグイン・フォント・既定アプリを omasushi.yaml に追記します。追記だけで、消したり並べ替えたりはしません。mine を決めてあればそこへ、決めていなければ --to で行き先を指定します。use: で土台にしている皿が既に持っているものは混ざりません。

オプション

• --to <name> — 書き込む omakase
• --host <name> — hosts.<name> の下に書く（GPU やモニタなど、そのマシン固有のもの）

omasushi export                    # into your own (mine)
omasushi export --to my-setup
omasushi export --host laptop      # under hosts.laptop

omasushi publish [<name> | <repo> | <path>] [--dry-run]レーンに流す

origin から owner/repo を読み、omasushi.yaml が commit & push 済みかを確かめて、記入済みの「Submit an omakase」issue をブラウザで開きます。Submit を押すと GitHub Actions が検証し、通れば皿の URL がコメントされます。

オプション

• --dry-run — issue の URL を表示するだけで、何も開かない
• --submit-repo <owner/repo>（または $OMASUSHI_SUBMIT_REPO）— 別の提出先リポジトリ

cd my-omakase
omasushi publish             # reads the git remote
omasushi publish owner/repo  # or say which one
omasushi publish --dry-run   # just print the issue URL

omasushi skill install|update|remove|list [--agent <name>]CLI の使い方をエージェントに入れる

同梱の omasushi skill を ~/.claude/skills/omasushi などにコピーします。install / update / remove / list があり、omakase は要りません。新しく go install したあとは update で書き直してください。

オプション

• --agent <name> — claude / codex / gemini / copilot / opencode（既定は Omarchy の既定エージェント）

omasushi skill install                 # the default agent
omasushi skill install --agent codex
omasushi skill list

omasushi versionバージョンを表示

不具合を報告するときはこの出力を添えてください。

$ omasushi version
omasushi v0.2.0