larksuite/cli

lark-cli – Lark/Feishu 用コマンドラインインターフェース

何であるか – Go/Nodeで書かれたオープンソースCLIで、人間とAIエージェントがLark/Feishu生産性スイートとやり取りできるようにします。200以上の使いやすいコマンドと、AI駆動の自動化に特化して設計された「スキル」のセットを、2,000以上のOpen Platform APIの背後でラップしています。

主な機能

• 広範なカバレッジ – カレンダー、メッセンジャー、ドキュメント、ドライブ、スプレッドシート、スライド、タスク、メール、会議、OKR、Wiki、連絡先、承認、勤怠、Baseテーブルなど。
• 3層構造のコマンドモデル
  1. ショートカット (+agenda, +messages-send) – 人間とAIの両方に使いやすく、デフォルト値とテーブル出力付き。
  2. APIコマンド – Lark Open APIエンドポイントへの自動生成された1対1マッピング。
  3. ローカルAPI – 2,500以上のエンドポイントのいずれにも直接呼び出し可能。
• エージェントネイティブな「スキル」 – 24の事前パッケージ化されたスキルモジュール（例：lark-calendar, lark-im, lark-doc）を提供。AIエージェントが使いやすいクリーンで型安全なインターフェースを提供し、ボットやその他の自動化パイプラインに簡単に統合できます。
• セキュリティ最優先 – OSキーチェーンによる資格情報の安全な保存、入力インジェクション対策、オプションのDPoP（Proof-of-Possession）認証、Feishuに送信される情報は最小限（デバイス情報のみ）に制限された組み込みリスク制御信号。
• インストール方法 – npx @larksuite/cli@latest install でワンライナーでインストール、またはGo 1.23+でソースからビルド可能。
• 認証方法 – インタラクティブなTUIによるOAuthフロー、エージェント向けのデバイスコードモード、細かいスコープ選択が可能。

誰が使うべきか

• Larkサービスに素早くターミナルインターフェースを必要とする個人開発者。
• AIアシスタント、ボット、RPAパイプラインを構築するチームで、Larkデータへの信頼性の高い構造化アクセスが必要な場合。
• 内部ツールにCLIを埋め込み、集中管理された資格情報ストアと監査ログを備えた企業。

動作方法（概要）

1. パッケージをインストール。
2. lark-cli config init を実行してアプリを登録し、クライアントID/シークレットを保存。
3. 認証（lark-cli auth login）。
4. コマンドを実行 – ショートカット（lark-cli calendar +agenda）またはローカルAPI呼び出し（lark-cli api GET /open-apis/calendar/v4/calendars）。

出力形式 – JSON（デフォルト）、見やすい形式、テーブル、CSV、NDJSON。他のスクリプトやAIパイプラインに結果をパイプしやすい。

リスクと対策 – READMEは、AIエージェントが意図せず有害な操作を実行する可能性を警告しています。デフォルトで入力のサニタイズやトークン使用信号の制限といった保護機能が有効になっており、ユーザーはこれらの設定を緩めないよう推奨されています。

ライセンス – MIT。Lark/Feishuのサービス利用規約を遵守するという通常の要件があります。

---

すべての詳細はリポジトリのREADMEから直接引用されています。