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 を実行すると対話形式でセットアップが進みます。
- Notion API トークンの入力（入力時はマスキングされます）
- 同期するフォルダの選択
- 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でエラーが表示されていないか