このプロジェクトは、Linearのタスク管理とClaude Codeを連携させ、ローカルマシン上でClaudeエージェントセッションを実行する「linear-claude-bridge」を紹介しています。

主な機能と特徴:

• Linearでissueを割り当てたり、メッセージを送ることで、Claude Agent SDKセッションがローカルマシン上で開始されます。
• セッションは指定したワーキングディレクトリで実行され、そのディレクトリ内のCLAUDE.md指示、MCPサーバー、スキルなども利用可能です。
• エージェントからの返信は、Linearのissueのセッションスレッドに投稿されます。
• これは参照実装であり、1,000行未満で、フレームワーク不使用、テスト済みです。
• コーディングエージェントではなく、ユーザーのコンテキスト（知識ベース、オペレーションリポジトリ、プロジェクトディレクトリなど）を理解したエージェントとの対話に最適化されています。
• AnthropicのAPIキーは不要で、Claude Codeのサブスクリプション認証を利用します。

アーキテクチャ:
LinearからのWebhook（mention/delegate/follow-up prompt）を受け取り、AgentSessionEventを処理します。HMAC署名を検証し、セッションマッピングはJSONファイルに保存され、会話の継続を可能にします。

前提条件:

• Node 22+、常時稼働するマシン、Claude Codeのインストールとログイン
• Linearワークスペース（OAuthアプリケーション作成可能）
• サービスへの公開HTTPSルート（tailscale funnel, cloudflaredなどを利用）

セットアップ:
Linear OAuthアプリの作成、環境設定、npmでのインストール、Linearへのエージェントとしてのアプリインストール、Webhookの公開が必要です。

フィールドノート:
WebhookのプロンプトはagentActivity.content.bodyに格納されること、AgentSessionEventペイロードの構造、HMAC署名とタイムスタンプ検証、WebhookのACKとliveness制限、実行のシリアル化、Agent SDKのバージョン（0.3.x以上推奨）などが解説されています。

セキュリティ:
Webhookエンドポイントは署名を検証し、古いタイムスタンプを拒否します。エージェントをメンションできるユーザーは、KB_PATHで実行されるエージェントセッションを制御できるため、信頼できるワークスペースでのみ使用し、KB_PATHを慎重に設定することが推奨されます。

請求:
Claude Agent SDKは、Claude Codeサブスクリプションと標準プランの制限に基づいています。将来的な課金体系の変更に注意が必要です。