Folio Writer ☰

Folio Helper

小さな無料のコンパニオンアプリです。Mac App Store 版の Folio Writer が、Mac にすでにインストールされているツール——Apple のサンドボックスがアプリ自身による起動を許可していないツール——を使ってコンパイルできるようにします。

何のためのものか

App Store 版は Apple のサンドボックス内で動作し、外部プログラムの起動が禁じられています——Homebrew、MacTeX、TinyTeX でインストールした組版ツールも例外ではありません。Folio Helper はサンドボックスの外に置かれる小さなエージェントで、それらのツールを Folio Writer に代わって実行します：pandoc、pandoc-crossref、typst、xelatex / pdflatex / lualatex / latexmk、tectonic、quarto、そして claude と codex のコマンドライン。これをインストールすれば、自分の LaTeX による PDF へのコンパイル、Quarto による .qmd プロジェクトのレンダリング、執筆アシスタントの Claude CLI モード（Folio Writer 1.18 からは Codex 経由の ChatGPT も）が、すべて 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 の公証の確認に一度応じれば、ヘルパーとのやり取りはそれで終わりです。それ以降は自動的に最新の状態に保たれます。

手動の場合：

1. 上の zip をダウンロードして展開します（Safari がすでに展開しているかもしれません）。
2. Folio Helper.app をアプリケーションフォルダにドラッグします。
3. 一度開きます。ウインドウはありません——バックグラウンドのヘルパーとして自身を登録し、システム設定 ▸ 一般 ▸ ログイン項目 に「Folio Helper」として表示されます。
4. Folio Writer でコンパイル ▸ 外部ツールを設定… を開き、再チェックを押します。ヘルパーのカードに、見つかったすべてのツールがパスとバージョンとともに一覧表示されます。

できること、しないこと

• 実行するのは上記の固定されたツール一覧だけです——それ以外のものを実行させることはできません。
• 実行するのは Folio Writer から求められたときだけです。接続が Folio Writer からのものであることは、コード署名で検証されます。
• ウインドウもメニューバー項目もなく、独自のネットワークアクセスもなく、何も収集しません。ツールは通常の場所（Homebrew、MacTeX、TinyTeX、npm、Volta、/usr/local）と、ログインシェルの PATH から探します。

アンインストール

終了させてから（システム設定 ▸ ログイン項目 ▸「Folio Helper」をオフ）、アプリケーションフォルダから Folio Helper.app を削除します。Folio Writer はそのまま使え、コンパイルはサンドボックスが許す範囲に戻るだけです。