macOSの既定のブラウザとして登録しておき、開いたリンクを設定ファイルのルールに応じて、指定したブラウザとプロファイルへ振り分けるアプリ Chizu 🧀 を作りました。

• GitHub: azu/chizu

Chizuには、ブラウザを選ぶ画面や設定画面はありません。 振り分けのルールは~/.config/chizu/config.jsoncというJSONCファイルに書き、リンクを開くたびにこのファイルを読み直します。 行き先にはブラウザのプロファイルも指定でき、現時点ではDia、Google Chrome、Firefoxのプロファイル指定に対応しています。

インストール

動作環境は次のとおりです。

• Apple SiliconのMac + macOS 14以降

次のコマンドでインストールし、ChizuをmacOSの既定のブラウザに設定できます。 いつも通りnotarizationはしてないので、自己判断でご自由にどうぞ。

curl -fL https://github.com/azu/chizu/releases/latest/download/chizu-macos-arm64.zip -o "$TMPDIR/chizu-macos-arm64.zip" &&
curl -fL https://github.com/azu/chizu/releases/latest/download/chizu-macos-arm64.zip.sha256 -o "$TMPDIR/chizu-macos-arm64.zip.sha256" &&
(cd "$TMPDIR" && shasum -a 256 -c chizu-macos-arm64.zip.sha256) &&
mkdir -p "$HOME/Applications" &&
ditto -x -k "$TMPDIR/chizu-macos-arm64.zip" "$HOME/Applications" &&
xattr -dr com.apple.quarantine "$HOME/Applications/Chizu.app" &&
/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -f "$HOME/Applications/Chizu.app" &&
"$HOME/Applications/Chizu.app/Contents/MacOS/chizu" default set

ダウンロードしたZIPは、一緒に公開しているSHA-256のチェックサムと照合してから展開しています。 アプリはバージョン間で同じ自己署名の証明書で署名していて、Appleの公証（notarization）はしていないため、xattrでquarantine属性を解除しています。

なぜ作ったか

これまでは、リンクをURLやリンク元のアプリに応じて振り分けるmacOSアプリのChoosyを使っていました。 Choosyには、URLやリンク元のアプリを条件にしたルールを設定できます。

Chizuを作った主な理由は2つあります。

1つ目は、ChoosyがDiaのプロファイル指定に対応していなかったことです。 Diaは、Arcを作ったThe Browser Companyによるブラウザです。 ChoosyからDiaでリンクを開くことはできますが、プロファイルを指定して開くことはできませんでした。

2つ目は、設定を複数のMacで共有したかったことです。 Choosyには、設定を複数の端末で共有する標準的な方法が用意されておらず、plistファイルを扱う形になっていました。 振り分けのルールは普通のファイルとしてGitで管理し、差分を確認しながら複数のMacで同期したいと考えていました。

そこで、設定ファイルでルールを管理でき、ブラウザのプロファイルまで指定できる既定のブラウザとしてChizuを作りました。 設定ファイルはシンボリックリンクでも読めるので、dotfilesのリポジトリでGit管理できます。

仕組み

Chizu自体はWebページを表示しません。 ChizuをmacOSの既定のブラウザとして登録しておき、リンクを受け取ったら設定ファイルのルールで行き先を決めて、実際のブラウザで開きます。

処理の流れは次のとおりです。

1. macOSが、他のアプリで開いたリンクを既定のブラウザであるChizuへ渡す
2. Chizuが設定ファイルを読み込んで検証する
3. 上から順にルールを評価し、最初に一致したルールの行き先を決める
4. 行き先のブラウザでURLを開く（プロファイルの指定があれば、そのプロファイルで開く）

詳しい仕組みは、Chizuのリンクの振り分けの設計に書いています。 リンク元のアプリは、macOSから受け取ったApple Eventの送信元から判別できた場合だけ、ルールの条件に使います。

使い方

Chizuは、chizuコマンドで設定ファイルを作って確認してから、既定のブラウザに設定して使います。

1. chizu config initで設定ファイルを作る
2. ~/.config/chizu/config.jsoncにルールを書く
3. chizu config checkとchizu check URLで、ルールの結果を確認する
4. chizu default setでmacOSの既定のブラウザをChizuにする

# 設定ファイルを作る（既にファイルやシンボリックリンクがある場合は上書きしない）
~/Applications/Chizu.app/Contents/MacOS/chizu config init
# 設定ファイルにエラーがないか検査する
~/Applications/Chizu.app/Contents/MacOS/chizu config check
# リンクを開かずに、一致するルール・ブラウザ・プロファイルを表示する
~/Applications/Chizu.app/Contents/MacOS/chizu check 'https://team.example.com/projects/123'
# Mailから開いた場合を想定して確認する
~/Applications/Chizu.app/Contents/MacOS/chizu check 'https://calendar.example.com/' --source com.apple.mail
# macOSの既定のブラウザをChizuにして、状態を確認する
~/Applications/Chizu.app/Contents/MacOS/chizu default set
~/Applications/Chizu.app/Contents/MacOS/chizu default status

chizu check URLはリンクを開かないので、既定のブラウザを切り替える前にルールの結果を確かめられます。 設定ファイルが壊れている場合や、指定したブラウザやプロファイルが見つからない場合はエラーとして報告します。 別のブラウザやプロファイルで黙って開くことはしないので、意図しないアカウントでリンクを開いてしまうことを避けられます。

設定ファイルはリンクを開くたびに読み直すため、設定を変更してもアプリの再起動は不要です。

設定ファイルの書き方

設定ファイルは、version、ルールに一致しなかったときの行き先であるdefault、上から順に評価するrulesの配列で構成されています。 各ルールはname、条件を書くwhen、行き先を書くdestinationを持ち、最初に一致したルールの行き先でリンクを開きます。

{
  "version": 1,
  // どのルールにも一致しなかったときの行き先
  "default": { "bundleID": "com.apple.Safari" },
  // 上から順に評価して、最初に一致したルールを使う
  "rules": [
    {
      "name": "Docs in Chrome",
      "when": { "host": "docs.example.com" },
      // Chromeに表示されているプロファイル名を指定する
      "destination": { "bundleID": "com.google.Chrome", "profile": "Work" }
    },
    {
      "name": "Team links",
      // ホストとパスの前方一致の両方を満たすときだけ一致する
      "when": { "host": "team.example.com", "pathPrefix": "/projects" },
      "destination": { "bundleID": "company.thebrowser.dia", "profile": "Team" }
    },
    {
      "name": "Calendar links from Mail",
      // Mailから開いたリンクのときだけ一致する
      "when": { "urlContains": "calendar", "sourceBundleID": "com.apple.mail" },
      "destination": { "bundleID": "com.google.Chrome" }
    },
  ],
}

whenには、次の条件を書けます。 1つのwhenに複数の条件を書いた場合は、すべてを満たしたときだけ一致します。

設定ファイルはJSONCなので、//や/* ... */のコメントと末尾のカンマを書けます。 末尾のカンマは、JSONCの仕様ではパーサーが任意で対応してよい拡張として扱われていて、Chizuはこれを受け付けています。

AIに設定してもらう

chizu --helpには、コマンドの書式に加えて、設定ファイルの項目や評価の順序、コピーして使える例を表示しています。 そのため、AIエージェントに--helpを読ませれば、設定ファイルを書いてもらえます。

たとえば、次のようなプロンプトの末尾に振り分けの希望を書いて、AIエージェントに渡します。

~/Applications/Chizu.app/Contents/MacOS/chizu --help を見て、Chizuを設定して。
~/.config/chizu/config.jsonc がなければ chizu config init で作って、次の希望に合わせてルールを書いて。
書いたら chizu config check と chizu check URL で、各ルールとどのルールにも一致しないURLの結果を確認して見せて。
問題がなければ chizu default set で既定のブラウザにして。

振り分けの希望:
- GitHubのリンクは、Chromeの「Work」プロファイルで開く
- それ以外は、Safariで開く

READMEにも、英語版のプロンプトを載せています。

• Configure with an AI

ブラウザのプロファイルを指定する

destinationのprofileには、ブラウザに表示されているプロファイル名を指定します。 現時点でプロファイルの指定に対応しているのは、次のブラウザです。

• Dia（company.thebrowser.dia）
• Google Chrome（com.google.Chrome）
• Firefox（org.mozilla.firefox）

Firefoxは、v1.3.0で対応しました。 他のブラウザのプロファイル指定を追加するのは難しくないので、必要なブラウザがあれば追加できます。

Diaのプロファイル指定には、Diaが提供しているAppleScriptの機能を使っています。 指定したプロファイルに新しいタブを作り、そのタブを選択してからDiaを前面に出します。 初めてDiaへ振り分けるときに、macOSからオートメーションの許可を求められるので、ChizuがDiaを操作することを許可します。

Diaのプロファイルを切り替える方法としては、Dia Routerのように、プロファイル切り替えのキーボードショートカットを送る方法もあります。 Chizuでは、ショートカットの設定や切り替えの待ち時間に依存しないように、AppleScriptで操作する方法を選んでいます。

Chromeのプロファイル指定では、まずChromeのLocal Stateファイルから、プロファイル名とディレクトリの対応を読み取ります。 そのディレクトリを--profile-directoryオプションで指定して、Chromeを起動します。 同じ名前のプロファイルが複数ある場合や見つからない場合は、リンクを開かずにエラーとします。 Local Stateは他のアプリのデータなので、初回はChizuからGoogle Chromeのデータへのアクセスを許可します。 許可はシステム設定 → プライバシーとセキュリティ → ファイルとフォルダから行えます。

Firefoxのプロファイル指定では、profiles.iniからプロファイル名と保存先を読み取り、-Pオプションでプロファイルを指定してFirefoxを起動します。 指定するのはabout:profilesに表示されるプロファイル名です。 Firefoxの新しい「プロファイル」メニューで作ったプロファイルは別の仕組みで管理されているため、対象外です。 この違いは、Mozillaのプロファイルのドキュメントで説明されています。

ブラウザ内のリンクも振り分ける

macOSの既定のブラウザを経由するのは、メールやチャットなど、ブラウザ以外のアプリから開いたリンクです。 ブラウザの中で開いたリンクは、そのブラウザ自身が開くため、Chizuには届きません。

そこで、Chizuはchizu-http:とchizu-https:というURLスキームも登録しています。 この仕組みは、@delphinusさんが#3で追加してくれました。 ユーザースクリプトやブラウザ拡張で、リンクのhttps:をchizu-https:に置き換えて開くと、Chizuが先頭のchizu-を取り除いてから、通常のリンクと同じルールで振り分けます。

# chizu-https: のリンクも同じルールで確認できる
~/Applications/Chizu.app/Contents/MacOS/chizu check 'chizu-https://team.example.com/projects/123'

chizu://open?url=...のようにURLをクエリパラメーターで渡す方法では、元のURLをエンコードしなければなりません。 スキームだけを置き換える方法なら、エンコードせずに元のURLをそのまま渡せます。

どのリンクをChizuへ渡すかは、ブラウザ側のユーザースクリプトや拡張で決めます。 渡したリンクの行き先が送り元のブラウザだった場合はそのブラウザで開くので、設定ファイルで別のブラウザへ振り分けるリンクだけを渡すようにします。

sdevで仕様から開発している

コントリビュートした人は気づいた通り、Chizuはsdevという開発ツールを使って開発しています。 sdevは、人とAIで仕様（Specification）を書いてからソフトウェアを作るための、仕様駆動開発のツールです。

Chizuのリポジトリでは、docs/products/以下に、目的と対象利用者を書いたProduct、機能ごとのRequirementsとDesignを置いています。 変更するときは、先に仕様を更新してから、実装とテストを変更する流れで開発しています。 仕様は英語を正本として、日本語版も同じ変更で更新しています。

• Chizu の仕様

この記事で書いた「なぜプロファイルが見つからないときはエラーとするのか」や「なぜスキームを置き換える方式にしたのか」といった判断も、仕様のドキュメントで説明しています。

まとめ

Chizuは、開いたリンクを設定ファイルのルールに応じて、ブラウザとプロファイルへ振り分けるmacOSアプリです。 設定はJSONCファイルなので、dotfilesに入れてGitで管理できます。

凝った機能はなく、ChoosyでDiaのプロファイルを指定できなかったので作ったアイデアアプリです。

• GitHub: azu/chizu
• 仕様: Chizu の仕様