lark-cli

Lark CLI

このスキルでは、最短手順の例とリファレンスへのリンクを使って、lark CLI で Feishu／Lark 製品（IM、Drive、Docs、Sheets、Mail、Calendar、Wiki、Bitable、Tasks など）を操作します。

このリポジトリで提供するもの

• lark CLI：Feishu／Lark 製品（IM、Drive、Docs、Sheets、Mail、Calendar、Wiki、Bitable、Tasks）にアクセスするための単一バイナリです。
• 2 種類の出力モード：デフォルトでは人間が読みやすい表形式、自動化では --json による JSON 形式です。
• 公式の oapi-sdk-go を使った SDK 優先の実装です。

クイックスタート（最小限）

1. CLI をインストールします（references/INSTALL.md を参照）。
2. 認証します。
   • テナントトークン（アプリのみ、ボット／アプリの ID）：lark auth tenant
   • ユーザートークン（ユーザーのスコープで、ユーザーに代わって操作）：lark auth user login 詳細とスコープについては、references/AUTH.md を参照してください。
3. コマンドを実行します。

lark whoami
lark chats list --limit 10
lark users search "Ada" --json

基本概念（要約）

• Feishu = Lark（グローバルブランド）。API サーフェスは同じですが、API エンドポイントは異なります。
• ほとんどのコマンドは、次の形式です：lark <product> <action> [args] [flags]。
• 必須 ID は位置引数です（必須の --id フラグはありません）。
• 多くのコマンドでは、ID の代わりに Lark／Feishu の Web URL を指定できます。
• --json は機械可読な出力を標準出力に書き込み、ログ／エラーは標準エラー出力に書き込みます。

概要については、references/CONCEPTS.md を参照してください。

テナントトークンとユーザートークンの使い分け

• テナントトークン：ボット／アプリの ID でアプリレベルの操作を行います。
• ユーザートークン：特定のユーザーに代わって、ユーザースコープの操作を行います。

コマンドでスコープエラーが発生した場合は、references/TROUBLESHOOTING.md を確認してください。

トークンタイプの使い方

--token-type を使って、アクセストークンのタイプを指定します。

• --token-type auto：デフォルトです。コマンドの要件に基づいて自動選択します。
• --token-type tenant：テナントトークンを強制します。
• --token-type user：ユーザートークンを強制します。

例：

lark whoami --token-type tenant
lark drive list --token-type user

エージェント向けワークフロー

• --json を優先して使い、ツール／スクリプトで解析します。
• ページネーションが多いコマンドでは、--limit ／ --pages を使います。
• 複数ユーザーのシナリオでは、--account または LARK_ACCOUNT を再利用します。

ユーザー向けの出力スタイル（重要）

ユーザーに代わって lark コマンドを実行する場合：

• デフォルトでは、生の CLI コマンドや詳細なターミナル出力をユーザーにそのまま表示しないでください。
• 結果を人間が読みやすい言葉で要約します（変更内容／見つかったもの／次のアクション）。
• 正確なコマンド／出力を含めるのは、ユーザーから明示的に求められた場合、またはデバッグ／再現に必要な場合に限ります。
• ID／トークンよりも、短いリストと直接リンク（Docx／Sheet の URL）を優先します。

よく使うレシピ

一般的なタスク（メッセージの送信、ユーザーの検索、ドキュメントの読み取りなど）については、references/RECIPES.md を参照してください。

詳細リファレンス

• インストール：references/INSTALL.md
• 認証とスコープ：references/AUTH.md
• 概念と ID：references/CONCEPTS.md
• レシピ：references/RECIPES.md
• トラブルシューティング：references/TROUBLESHOOTING.md
• 補完：references/COMPLETION.md
• ドキュメント：references/DOCS.md
• Sheets：references/SHEETS.md
• Bitable ベース：references/BASES.md
• Drive：references/DRIVE.md
• 議事録：references/MINUTES.md
• カレンダー：references/CALENDARS.md
• 会議：references/MEETINGS.md
• チャット：references/CHATS.md
• メッセージ：references/MESSAGES.md
• 連絡先：references/CONTACTS.md
• Mail：references/MAIL.md
• タスクリスト：references/TASKLISTS.md
• タスク：references/TASKS.md
• ユーザー：references/USERS.md
• 設定：references/CONFIG.md
• 自分の情報：references/WHOAMI.md
• Wiki：references/WIKI.md