zarazhangrui/lark-coding-agent-bridge

解決する課題

このプロジェクトは、Feishu/Lark メッセンジャーと Claude Code や Codex CLI のようなローカル AI コーディングエージェントとの間のブリッジを提供します。これにより、ユーザーはチャットインターフェースからローカルの開発環境やコーディングエージェントと直接対話できるようになり、すべての操作のためにターミナルを開いておく必要がなくなります。

仕組み

このブリッジは、Feishu/Lark からローカルのエージェントプロセスへメッセージを転送するミドルウェアとして機能します。セッション、作業ディレクトリ、およびファイル添付を管理します。PersonalAgent アプリを使用してメッセンジャーの API に接続し、初回実行時に QR コードウィザードを通じて設定できます。

対象ユーザー

Claude Code や Codex CLI を使用しており、利便性、リモートアクセス、またはチームコラボレーションのために、モバイルまたはデスクトップのチャットアプリ（Feishu/Lark）経由でローカルのコーディングエージェントにアクセスしたい開発者。

ハイライト

• リアルタイムストリーミング: テキストの返信とツール呼び出しを、単一の Lark カード上でリアルタイムに更新します。
• セッション管理: 異なるチャット、トピック、またはドキュメントのコメントスレッドに対して個別のセッションを維持します。
• ワークスペース制御: /cd を使用したプロジェクトディレクトリの切り替えと、/ws による名前付きワークスペースの保存をサポートします。
• アクセス制御: デフォルトではプライベート設定ですが、特定のユーザー、グループ、または管理者を招待するための詳細な権限設定が可能です。
• COT プロセスの可視化: 最終的な回答の前に、ツール呼び出しや進捗テキストを含むエージェントの「Chain of Thought (COT)」プロセスをオプションで表示します。
• ファイル処理: チャット経由で送信された画像やファイルを、ローカルエージェントの環境に自動的にダウンロードします。
• バックグラウンドサービス: 永続的な可用性のために、OS 管理のデーモン（systemd、launchd、または Windows Task Scheduler）として実行できます。