Toukan CLI セットアップガイド

Toukan の機能をターミナルから操作できる CLI ツールです。Homebrew で追加インストールして、開発フローに組み込めます。

前提条件

  • macOS 14.0 (Sonoma) 以上
  • Homebrew がインストール済みであること
  • Mac App Store 版 Toukan は不要（CLI 単体で動作）
    ※ GUI と併用する場合は別途インストール

インストール

brew install bon-clevique/tap/toukan

インストール確認：

toukan --version

初回セットアップ

toukan setup を実行すると対話形式でセットアップが進みます。

  1. Notion API トークンの入力（入力時はマスキングされます）
  2. 同期するフォルダの選択
  3. Notion データソース ID の入力と検証
toukan setup

基本コマンド一覧

コマンド 用途
toukan setup 初回セットアップウィザード
toukan list 同期ターゲット一覧表示
toukan add <folder> --data-source <id> 同期ターゲット追加
toukan remove <folder> 同期ターゲット削除
toukan status 設定状態と各フォルダの統計表示
toukan sync 全ターゲットを一括同期
toukan sync <files...> 指定ファイルのみ同期

Claude Code 連携

Claude Code を利用している開発者向けに、リファレンスドキュメントを自動配置するコマンドを提供しています。 

toukan config install-claude-ref

~/.claude/rules/toukan.md に配置され、Claude Code が Toukan 経由の Markdown 出力ルールを参照できるようになります。

アップデート

brew upgrade toukan

トラブルシューティング

トークンを再設定したい 
toukan config set notion-token
設定状態を確認したい 
toukan status
同期されない

以下を確認してください：

  • 監視フォルダのアクセス権限
  • Notion 側のデータソース共有設定
  • toukan status でエラーが表示されていないか

関連リンク