Folio Writer
Folio Helper
小さな無料のコンパニオンアプリです。Mac App Store 版の Folio Writer が、Mac にすでにインストールされているツール——Apple のサンドボックスがアプリ自身による起動を許可していないツール——を使ってコンパイルできるようにします。
バージョン 1.6.4 · 無料 · Apple による公証済み · macOS 13 以降。必要なのは Mac App Store 版だけで、しかも自分でインストールしたツールを使う場合だけです。
1.6.4 の新機能——より速く、より頑丈なヘルパーに。すべてのツールを一度に探し、見つけた場所を記憶するので、コールドスタート時にときどき「ツールなし」と表示されることもなく、ツールパネルが 1、2 秒で埋まります。コンパイル ▸ 停止は、最上位のプロセスだけでなく、レンダラーが起動したすべて（latexmk の xelatex、Quarto の pandoc と Jupyter）を停止するようになりました。また、ツールが途中で終了しても、コンパイルの最中にヘルパーが道連れになることはなくなりました。自動アップデートがオンなら、すでにお手元にあります。
すでに Folio Helper をお持ちですか？ Folio Writer 1.8.6 と Folio Helper 1.6.3 からは、アップデートは自動です。アプリが 1 日に 1 回ほど新しいリリースを確認し、ダウンロードしたもののコード署名を検証し、実行中のヘルパーがバックグラウンドで静かに自分自身を置き換えます——ダイアログも、クリックも、承認も不要です。先に確認してほしい場合は、設定 ▸ コンパイルでオフにできます。手動のアップデートボタンはコンパイル ▸ 外部ツールを設定…にあります。
Folio Writer 1.8.4 以前をお使いですか？ それらのバージョンには Folio Helper 1.5 が対応します（それらのリンクが指している、バージョン番号なしの FolioHelper.zip でも配布しています）。
手動でのアップデートもできます。Folio Writer を終了し——Folio Helper も一緒に終了します——アプリケーションフォルダの Folio Helper.app を新しいものに置き換えて、Folio Writer を再度開いてください。
何のためのものか
App Store 版は Apple のサンドボックス内で動作し、外部プログラムの起動が禁じられています——Homebrew、MacTeX、TinyTeX でインストールした組版ツールも例外ではありません。Folio Helper はサンドボックスの外に置かれる小さなエージェントで、それらのツールを Folio Writer に代わって実行します：pandoc、pandoc-crossref、typst、xelatex / pdflatex / lualatex / latexmk、tectonic、quarto、そして claude コマンドライン。これをインストールすれば、自分の LaTeX による PDF へのコンパイル、Quarto による .qmd プロジェクトのレンダリング、執筆アシスタントの Claude CLI モードが、すべて App Store 版で使えるようになります。
まだツールをお持ちでない？ ターミナルで一つのコマンドを実行すれば、pandoc、pandoc-crossref、Quarto、Typst、LaTeX エンジンをインストールできます（必要なものを選ぶメニューが表示されます）。
curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash
インストール方法
簡単な方法（Folio Writer 1.8.5 以降）：コンパイル ▸ 外部ツールを設定… を開き、Folio Helper をインストールをクリックします。Folio Writer がダウンロードし、署名を検証し、アプリケーションフォルダに配置します——アプリケーションフォルダへのアクセスを一度だけ承認し、macOS の公証の確認に一度応じれば、ヘルパーとのやり取りはそれで終わりです。それ以降は自動的に最新の状態に保たれます。
手動の場合：
- 上の zip をダウンロードして展開します（Safari がすでに展開しているかもしれません）。
- Folio Helper.app をアプリケーションフォルダにドラッグします。
- 一度開きます。ウインドウはありません——バックグラウンドのヘルパーとして自身を登録し、システム設定 ▸ 一般 ▸ ログイン項目 に「Folio Helper」として表示されます。
- Folio Writer でコンパイル ▸ 外部ツールを設定… を開き、再チェックを押します。ヘルパーのカードに、見つかったすべてのツールがパスとバージョンとともに一覧表示されます。
できること、しないこと
- 実行するのは上記の固定されたツール一覧だけです——それ以外のものを実行させることはできません。
- 実行するのは Folio Writer から求められたときだけです。接続が Folio Writer からのものであることは、コード署名で検証されます。
- ウインドウもメニューバー項目もなく、独自のネットワークアクセスもなく、何も収集しません。ツールは通常の場所（Homebrew、MacTeX、TinyTeX、
/usr/local）と、ログインシェルのPATHから探します。
アンインストール
終了させてから（システム設定 ▸ ログイン項目 ▸「Folio Helper」をオフ）、アプリケーションフォルダから Folio Helper.app を削除します。Folio Writer はそのまま使え、コンパイルはサンドボックスが許す範囲に戻るだけです。