Flue Framework とは?Astro チームが2026年6月に公開した TypeScript AI エージェント・ハーネス(Cloudflare Agents SDK / Pi / Durable Objects 上に構築) Write once, deploy anywhere, use any LLM を掲げ、Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify 等 25+ 連携、React hooks(useFlueAgent / useFlueWorkflow)搭載
Flue Framework(公式 / 1.0 Beta 発表ブログ / Cloudflare 提携ブログ)は、Astro チーム が2026年6月17日週に 1.0 Beta として公開した TypeScript の AI エージェント・ハーネスフレームワーク。Write once, deploy anywhere, use any LLM をコンセプトに、Slack・GitHub・Linear・Discord・Notion・Stripe・Shopify・Teams・Telegram・Twilio・WhatsApp など 25+ のチャネル連携 を最初から搭載しています。
3層構成:
- Framework layer: Flue(プロジェクト構造・規約・統合・CLI)
- Harness layer: Pi(agentic loop、tool 呼出、context 管理)
- Runtime layer: Cloudflare Agents SDK(compute・state・storage)
Cloudflare 統合の核心: Flue を Cloudflare にデプロイすると 各エージェントが Durable Object になる(前作コラム参照)。runFiber() / stash() / onFiberRecovered() で SQLite checkpoint を取り、障害後の自動再開が可能。@cloudflare/codemode(Dynamic Workers で agent-generated TypeScript を安全実行、10ms 未満起動・$0.002/load)、@cloudflare/shell(SQLite バック virtual filesystem)、@cloudflare/dynamic-workflows(永続化 + retry + 外部承認対応の workflow)を組み合わせた実装。
5つのコアプリミティブ:
1. Agents — 自律的な context-aware エージェント
2. Workflows — 決定論的ステップ実行
3. Sandboxes — 安全なツール実行環境
4. Channels — Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify 等 25+
5. Durable Streams — event 転送(受信済み work は消えない)
その他機能: @flue/react(useFlueAgent / useFlueWorkflow フックでフロントエンドから直結)、@flue/sdk(デプロイ済みエージェントへのクライアント)、flue add(shadcn 風の統合スキャフォールド)、Subagents(役割分担)、Tools & Skills(型付き API アクション + 再利用可能な expertise)、MCP 統合、Observability(OpenTelemetry / Braintrust / Sentry)。
マルチデプロイ: Cloudflare Workers / Node.js / AWS / Docker / Railway / Render / Vercel / Fly / GitLab CI / SST。DB: PostgreSQL / Supabase / MongoDB / MySQL / Redis。
背景: Astro(astro.build の Web フレームワーク)チームが 自社の GitHub リポジトリ内で AI ワークフローを自動化するために社内利用していたエンジン を汎用フレームワーク化。Astro チームは DX(Developer Experience)設計で定評 があり、CLI と統合の洗練度が持ち味。
位置付け: Cloudflare Agents SDK 上の 最初の主要な agent framework、Claude Code や他の coding agent と同じ harness-driven architecture、そして LangChain / LlamaIndex / AutoGen / CrewAI / Mastra の系列にも属さない フレームワーク層に特化した「軽さ + 統合の広さ」 で差別化。バグトリアージエージェントを 25 行以下で実装 できる例が公式デモ。
TL;DR — Flue Framework を一言で
Flue Framework は、Astro チーム(Web フレームワーク Astro の開発チーム)が 2026年6月17日週に 1.0 Beta として公開 した、TypeScript の AI エージェント・ハーネスフレームワーク です(公式 / 1.0 Beta 発表ブログ)。
4 つの要点:
1. 『Write once, deploy anywhere, use any LLM』 — TypeScript ベース、LLM ベンダー非依存、Cloudflare / Node.js / AWS / Vercel / Fly / Docker 等マルチデプロイ
2. 3 層構成 — Framework(Flue)+ Harness(Pi)+ Runtime(Cloudflare Agents SDK / Durable Objects)
3. 25+ チャネル連携内蔵 — Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify / Teams / Telegram / Twilio / WhatsApp 等
4. Cloudflare デプロイで各エージェントが Durable Object 化 — SQLite checkpoint による自動 recovery、Dynamic Workers で agent-generated code を 10ms 未満で安全実行
本コラムは前作 Cloudflare Durable Objects 徹底解説・agmsg(CLI エージェント間メッセージング)・Sakana Fugu オーケストレーション・Claude Code Agent View と並ぶ 2026年のエージェント基盤プリミティブ 整理の一環です。
Flue とは何か — Astro チームの社内ツールが起源
Flue は Astro Web フレームワークを開発するチームが、自社の GitHub リポジトリ内で AI ワークフローを自動化するために構築した社内エンジンを、汎用フレームワークとして公開したもの。
Astro チームの DX(Developer Experience)設計に対する定評 がそのまま Flue にも反映されており、CLI・統合スキャフォールディング(flue add)・React hooks・型付き API まで 開発者体験の細部 に力が入っています。
Cloudflare の公式ブログでは Flue が 『Cloudflare Agents SDK 上に構築された最初の主要な agent framework』 として紹介されており(Cloudflare Blog: Bringing more agent harnesses and frameworks to Cloudflare, starting with Flue)、両者の戦略的パートナーシップが読み取れます。
3 層アーキテクチャ
Flue の設計を理解する鍵は 3 層構成:
| 層 | 役割 | 実装 |
|---|---|---|
| Framework layer | プロジェクト構造・規約・統合・CLI・DX | Flue |
| Harness layer | Agentic loop、tool 呼出、context 管理 | Pi |
| Runtime / Platform layer | Compute・state・storage | Cloudflare Agents SDK(他ランタイムも可) |
この分離の意義: Framework 層(Flue)はハーネス実装(Pi)と疎結合、ハーネスはランタイム(Cloudflare)と疎結合。各層を独立して選択・入れ替え可能 な設計。Cloudflare 以外に Node.js / AWS / Vercel / Fly でも動くのはこの分離のおかげ。
Cloudflare 統合 — Durable Objects への深い依存
Flue の Cloudflare デプロイ時の挙動が最も先進的:
(1) 各エージェント = 1 個の Durable Object
前作 Durable Objects コラムで解説した「名前で一意に決まるステートフルインスタンス」プリミティブを Flue が完全活用。エージェント ID をキーにした DO が自動生成され、単一マスター semantics が保証される。
(2) runFiber() / stash() / onFiberRecovered() による checkpoint
エージェントの進行状態を DO の内蔵 SQLite に checkpoint。障害・deploy・cold start をまたいで エージェントセッションが自動再開 される。従来 Temporal / Airflow / Prefect 級の workflow エンジンで担っていた durability が、DO の副産物として得られる。
(3) @cloudflare/codemode — 動的 TypeScript 実行の isolate
エージェントが生成した TypeScript コードを Dynamic Workers 上で安全実行。isolate 起動 10ms 未満、$0.002/load という驚異的な速度と価格。従来 Docker / Firecracker / gVisor で作っていた sandbox がプラットフォームプリミティブに置き換わる。
(4) @cloudflare/shell — SQLite バック仮想ファイルシステム
コンテナ起動不要で grep / read / write ができる virtual filesystem。エージェントがファイル操作系タスク(ログ解析・設定変更・コード編集)を扱う際、フルコンテナのオーバーヘッドなし で動作。
(5) @cloudflare/dynamic-workflows — 永続化 workflow
エージェントが動的に生成したマルチステップワークフローを 永続化 + 自動 retry + 外部承認待機 できる仕組み。人間承認を挟む承認フローや、外部 API 応答待ちの長時間処理を透過的に扱える。
5 つのコアプリミティブ
(1) Agents — Context-aware で自律的に目標に向かって動くエージェント。LLM 呼出・tool 呼出・reasoning ループ・エラー処理を Pi ハーネスが担い、Flue はそれを扱いやすい TypeScript API として提供。
(2) Workflows — 決定論的な step 実行。Agents(開放的な問題)と Workflows(正確な決められたステップ)を 同一フレームワーク内で使い分け られる設計。
(3) Sandboxes — ツール実行・ファイル変更・自律作業のための安全な環境。Cloudflare 上では @cloudflare/codemode + @cloudflare/shell が実装を担う。
(4) Channels — Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify / Teams / Telegram / Twilio / WhatsApp 等 25+ の外部サービス連携。エージェントを Slack bot・GitHub Action・Discord bot・Webhook 対応 API として即座に公開可能。
(5) Durable Streams — event 転送機構で「受け入れられた work は消えない」保証。Cloudflare Durable Objects のトランザクション性を活用したイベントバス。
その他の主要機能
@flue/react: React hooks useFlueAgent / useFlueWorkflow を提供。フロントエンドから リアルタイムストリーミング付きでエージェントを呼び出す ことがネイティブに書ける。カスタム WebSocket インフラを自前で組む必要なし。
@flue/sdk: デプロイ済みエージェントを呼び出すクライアントライブラリ。HTTP / RPC のラッパー。
flue add: shadcn-ui スタイルのスキャフォールディングコマンド。エージェント統合を追加する際に 必要なコード・設定・依存を CLI で自動生成。
Subagents: 特化した役割にタスクを委譲。親エージェントが多数の子エージェントを呼び出して並列作業。
Tools & Skills: 型付き API アクション(Tools)と 再利用可能な expertise パッケージ(Skills)を分離。Skills は他プロジェクトで再利用可能な npm パッケージ的位置付け。
MCP 統合: Model Context Protocol エコシステム対応。Anthropic 発の標準プロトコルで、既存 MCP サーバ資産(Datadog / Slack / 社内 CRM 等)をそのまま利用可能。
Observability: OpenTelemetry・Braintrust・Sentry の 3 種類の観測基盤を最初からサポート。エージェント実行のトレース・評価・エラー追跡がプロダクション品質で可能。
デプロイターゲット
Cloudflare 以外にも幅広い環境をサポート:
コンピュート:
- Cloudflare Workers(推奨、Durable Objects 完全活用)
- Node.js
- AWS Lambda
- Docker
- Railway、Render、Vercel、Fly
- GitLab CI、SST
データベース(Cloudflare 外での state 管理):
- PostgreSQL、Supabase
- MongoDB、MySQL
- Redis
Cloudflare 未使用時は Durable Objects の恩恵(DO 単一マスター semantics)が得られない ため、外部 DB での state 管理設計が必要になる点は留意。フル機能を活かすなら Cloudflare 推奨。
コード例 — バグトリアージエージェントを 25 行以下で
Cloudflare Blog が公式デモとして示す例:
import { defineAgent, tool } from '@flue/runtime';
import { github } from '@flue/channels';
const bugTriage = defineAgent({
name: 'bug-triage',
channels: [github({ events: ['issues.opened'] })],
system: 'You triage bug reports. Reproduce the bug in a sandbox, then diagnose.',
tools: [
tool('reproduce', async ({ code }) => {
// sandbox で agent-generated TypeScript を実行
return await sandbox.run(code);
}),
tool('comment', async ({ issue, body }) => {
return await github.postComment(issue, body);
}),
],
});
export default bugTriage;このコードで実現されること:
- GitHub の issue が新規オープンされた瞬間に自動起動
- LLM がバグ報告を解析して 再現用 TypeScript コードを生成
- Cloudflare Dynamic Workers の sandbox で 10ms 未満で isolate 起動して実行
- 実行結果を LLM が診断し、issue にコメント投稿
- 全プロセスが Durable Object 上で稼働し、途中障害があっても checkpoint から自動再開
同等機能を GitHub Actions + Docker + Node.js + Redis で自作すると、数百行のインフラコードと運用が必要。Flue の設計哲学が最もよく現れる例。
競合との位置付け
Agent framework 市場のマップ:
| Framework | 主な特徴 | ランタイム | Flue との差異 |
|---|---|---|---|
| LangChain | Python 中心、大規模エコシステム | 汎用 | Flue は TypeScript / DX 特化 |
| LlamaIndex | RAG・検索特化 | 汎用 | Flue は agent / workflow 汎用 |
| AutoGen(Microsoft) | Multi-agent conversation | Python | Flue は TypeScript / channel 統合広い |
| CrewAI | Role-based multi-agent | Python | Flue はより軽量 / 統合広い |
| Mastra | TypeScript agent framework | Node.js / Cloudflare | Flue と最も近い。Flue は Cloudflare Agents SDK 深統合が差別化 |
| Claude Code | Anthropic 公式 CLI | Anthropic クラウド | Flue は「あらゆる LLM で使える framework」なのに対し Claude Code は Anthropic 前提 |
| agmsg | CLI エージェント間メッセージング | ローカル SQLite | agmsg はメッセージング層のみ、Flue はフルスタックエージェント |
| Sakana Fugu | オーケストレーション・モデル | API サービス | Fugu は「LLM を呼ぶ LLM」、Flue はハーネス層 |
| Flue Framework(本コラム) | Astro DX + Cloudflare Agents SDK + Pi harness + 25+ 統合 | Cloudflare Workers 等 | — |
Flue の 3 つの差別化軸:
1. Cloudflare Agents SDK 深統合(Durable Objects / codemode / shell / dynamic-workflows を native 活用)
2. Astro チームの DX 品質(CLI・スキャフォールディング・React hooks の完成度)
3. 25+ チャネル統合内蔵(Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify 等を最初から)
想定ユースケース
- 社内 GitHub の自動化(Astro チーム自身のオリジナル用途)— issue triage、PR review、依存更新
- 顧客サポート自動化 — Slack / Discord / Intercom 経由の質問を Flue エージェントが処理
- 業務ワークフロー — 承認フロー、金融取引処理、外部 API との長時間連携
- AI SaaS の裏側 — Cursor iOS や Claude Code の様な agent プロダクトのバックエンド実装フレームワーク
- 開発者ツール構築 — カスタムのコーディングエージェント(社内リポジトリ理解・自動 PR 生成)
- マルチエージェント swarm — 特化 subagent 群による大規模タスク分担
運用上の留意点
(1) 1.0 Beta: 2026-06-17 週に beta リリース。API 変更・仕様変更の可能性 があり、本番運用には仕様安定を待つ判断も必要。ロードマップは「polish・documentation・multi-node scaling」を優先。
(2) Cloudflare 依存度: フル機能を活かすには Cloudflare Workers への deploy が推奨。他ランタイムでは Durable Objects の恩恵が得られない。Cloudflare Vendor lock-in を受け入れる判断が実質必要。
(3) TypeScript / Node.js 限定: Python エコシステム(LangChain / LlamaIndex / AutoGen / CrewAI)とは相互運用不可。既存 Python 資産が多い組織には移行コストが発生。
(4) Pi ハーネスの成熟度: Flue は Pi に依存しており、Pi 自体もまだ若いプロジェクト。両者の同時進化リスク がある。
(5) 実運用の学習コスト: 25+ channels・durable execution・sandbox の全機能を使いこなすには、Cloudflare Workers・Durable Objects・Pi の 3 層すべての理解が必要。軽量な単発スクリプトには過剰装備。
戦略文脈 — 2026 年後半の agent framework 市場
2026 年前半のエージェント framework 市場は Python 系(LangChain / AutoGen)と TypeScript 系(Mastra / Flue)の二極化 が進行しました。TypeScript 系は主に Web / SaaS 開発者にとってのフィット と Cloudflare / Vercel 等の edge runtime との親和性 で存在感を高めています。
Flue の戦略的位置:
1. Astro チームブランド — DX で定評あるチームの後押しは開発者コミュニティで強力
2. Cloudflare Agents SDK の公式ショーケース — Cloudflare 側のマーケティング支援が期待できる
3. 『Write once, deploy anywhere, use any LLM』の魅力 — 現在の LLM 市場変動(Fable 5 停止 → 復活・Sonnet 5 リリース・Grok Build)にとって、LLM lock-in 回避のフレームワーク選択は重要
4. channel 統合の広さ — Slack / GitHub / Linear / Discord / Notion / Stripe / Shopify 等の統合を最初から持つのは競合優位
本トピックに関連する弊社サービスとして ソフトウェア開発・AI コンサルティング・OpenClaw 導入セットアップ があります。Flue Framework や Cloudflare Agents SDK を含む TypeScript エージェント基盤の設計・実装、社内ワークフロー自動化のご相談は お問い合わせ から。
まとめ
Flue Framework は 2026 年 6 月 17 日週に Astro チームが 1.0 Beta として公開した TypeScript AI エージェント・ハーネスフレームワーク。『Write once, deploy anywhere, use any LLM』 のスローガンと、Framework(Flue)+ Harness(Pi)+ Runtime(Cloudflare Agents SDK)の 3 層構成、25+ の channel 統合、Durable Objects を活用した durable execution という 4 つの軸で、Cloudflare エコシステムに深く根ざした新世代の agent framework として登場しました。
3 つの本質的インパクト:
1. Cloudflare Agents SDK 上の最初のショーケース — Durable Objects / codemode / shell / dynamic-workflows を Framework 層で完全活用
2. DX 重視の Astro チーム設計 — CLI・React hooks・スキャフォールディングが従来 framework と一線を画す完成度
3. バグトリアージエージェントを 25 行以下 — 分散システム・durability・sandbox の複雑さを framework が吸収
留保: 1.0 Beta のため API 変更リスク、Cloudflare 依存度、TypeScript / Node.js 限定、Pi ハーネス成熟度、実運用の学習コスト。
References
公式:
- Flue Framework 公式
- Flue 1.0 Beta 発表ブログ
- Getting Started ドキュメント
- Astro Web Framework
Cloudflare 公式:
- Cloudflare Blog — Bringing more agent harnesses and frameworks to Cloudflare, starting with Flue
第三者解説:
- Developers Digest — Flue: The Agent Harness Framework and Why It Feels Different
- Better Stack Community — Flue: Headless, Programmable AI Agent Framework from the Astro Team
- Openflows — Flue: Open-Source Agent Harness Framework
- Open Source Alternatives — Flue Framework: Open Source Alternative to Devin AI
関連コラム:
- Cloudflare Durable Objects 徹底解説
- agmsg — CLI エージェント間メッセージング
- Sakana Fugu — オーケストレーション・モデル
- Claude Code Agent View — 並列オーケストレーション
- Cursor iOS — モバイルコーディングエージェント
- Claude Sonnet 5 リリース
- Claude Fable 5 復活
- Grok Build — xAI CLI コーディングエージェント
- Loop Engineering — Maker-Checker パラダイム
- Ornith-1.0 — DeepReinforce agentic coding LLM
お気軽にご相談ください
お問い合わせ