「Claude Agent SDK を使って社内向けの AI エージェント基盤を作れないか」「Cline や LibreChat とは別の選択肢はないか」——このような検討をしていて、GitHub の Trending や X の投稿で Craft Agents の名前を目にした方も多いのではないでしょうか。
Craft Agents は、ドキュメント作成 SaaS「Craft」を提供する Craft Docs Ltd. が OSS として公開したデスクトップ AI エージェントです。ただ、公式サイトと README を読み込んでも「Cline や LibreChat とどう違うのか」「自社の PoC に採用してよいか」「Apache-2.0 なら商用利用しても問題ないか」といった判断軸は一度で整理しづらく、GitHub の README をスクロールしながら頭の中でマッピングし直す作業が必要になります。
さらに悩ましいのは、AI エージェント OSS がここ 1 年で一気に増え、Cline（VS Code 拡張）、LibreChat（Web マルチプロバイダーチャット）、Emdash（コーディング CLI オーケストレーター）と、それぞれ「似ているようで守備範囲が異なる」プロダクトが並走している点です。どれか一つに絞る前に、Craft Agents が自社の要件のどこに刺さり、どこで見送るべきかを短時間で判断したいというのが、初見エンジニアの本音ではないでしょうか。
本記事では、Craft Agents のリポジトリメタデータと公式ドキュメントをもとに、「何をする OSS か」「主要機能とアーキテクチャ」「類似 OSS との違い」「導入判断のチェックリスト」「ライセンスとメンテナンス状況」を順に整理します。動作検証は行っておらず、GitHub リポジトリと公式ドキュメントの内容にもとづく紹介記事である点をあらかじめお断りしておきます。読み終えた段階で「PoC を立てるか、Cline や LibreChat で足りるか」の判断がつく状態を目指します。
Craft Agentsとは何か
Craft Agents は、craft-ai-agents/craft-agents-oss で公開されているオープンソースの AI エージェントデスクトップアプリケーションです。Claude Agent SDK と Pi SDK の 2 系統の LLM バックエンドを並列で扱い、コードだけでなくドキュメント業務を含めた「エージェントネイティブ」なワークフローを提供します。
リポジトリ基本情報
まずは GitHub API から取得した客観指標を押さえておきます。以下はワークフロー内で gh api /repos/craft-ai-agents/craft-agents-oss を用いて取得した値の一部です。
項目 | 値 |
|---|---|
リポジトリ | |
主要言語 | TypeScript |
ライセンス | Apache-2.0 |
スター数 | 6,654 |
フォーク数 | 917 |
最終 push | 2026-07-01 |
公開状態 | public |
archived | false |
fork | false |
disabled | false |
- archived / fork / disabled はいずれも false であり、フォーク版でもアーカイブされたプロジェクトでもありません。現行の Craft Docs Ltd. がメンテナンスを継続している本家リポジトリです。
- スター数は 1 万未満ながら 6,000 台後半に達しており、日本語圏でも Trendshift のバッジや Qiita 紹介記事、X の投稿で言及が出始めている段階です。
提供元と設計思想（Agent Native）
Craft Agents を公開しているのは、ドキュメント作成 SaaS「Craft」を運営する Craft Docs Ltd. です。README では「私たち自身がエージェントと効果的に働くために作った」と明言されており、Craft Agents 自身が Craft Agents を使って開発される、いわゆるドッグフーディング体制で運用されています。
同社が掲げる Agent Native software の考え方は次のポイントに集約されます。
- 設定ファイルやセットアップウィザードを排除し、プロンプトで指示すれば必要な API/MCP のドキュメントをエージェント自身が読み解き、認証・設定まで完結させます
- コード（エディタ）中心ではなく、ドキュメントを中心に据えたワークフローを前提にします
- CLI 前提の運用ではなく、意見の強い GUI 体験を提供します
この設計思想が、後述する Cline（VS Code 拡張）や LibreChat（Web チャット UI）との差を生む出発点になっています。
主な機能と特徴
Craft Agents の全体像は、公式サイト agents.craft.do の README/ドキュメントに整理されています。ここでは初見エンジニアが「機能マップ」を頭に入れられるよう、主要機能を 5 つのブロックに分けて整理します。
マルチセッション管理と Inbox ワークフロー
Craft Agents の中核はメールクライアントに近い Multi-Session Inbox です。各エージェントセッションは独立した「セッション」として扱われ、以下のようなステータスワークフローを持ちます。
- Todo → In Progress → Needs Review → Done
- Inbox / Archive の切り替え、Flag による優先度管理
複数タスクを並列に走らせつつ、進捗を GUI 上で一覧管理できる点が「エディタ内完結型」の Cline や、単発チャット中心の Web UI との明確な差になっています。
Sources と Skills（プロンプトで拡張する仕組み）
Craft Agents は、外部データソースを Sources と呼ばれる概念でまとめています。
- MCP（Model Context Protocol）サーバー
- REST API（Google, Slack, Microsoft 等）
- ローカルファイルシステム
これらを設定 UI ではなく、自然言語のプロンプトで追加できるのが特徴です。加えて Skills としてワークスペースごとの専門指示を持たせられ、Claude Code のスキル定義をインポートすることも可能とされています。
マルチプロバイダー LLM 対応
対応する LLM プロバイダーは README の Features セクションで列挙されており、代表的なものは以下です。
- Anthropic API
- Google AI Studio
- ChatGPT Plus（Codex OAuth）
- GitHub Copilot
- OpenAI API
- OpenRouter / Vercel AI Gateway
- Ollama（ローカル LLM）
これらをワークスペース単位でデフォルト接続として指定できるため、案件ごとに「基本は Claude、コスト重視のバッチは Ollama」といった使い分けがしやすい設計です。
Automations（イベント駆動の自動化）
長時間の自動運用を担うのが Automations です。公式ドキュメントの Automations Overview で概念が整理されています。
- 発火イベント:
LabelAdd/LabelRemove/SessionStatusChange/SchedulerTick（cron） /PreToolUse/PostToolUse/SessionStart/SessionEndなど - アクション: シェルコマンド実行（
command型）または新規セッション生成（prompt型） - 自然言語で「毎週金曜 17 時に今週の完了タスクをまとめて」のように指示できます
Cline や LibreChat では、cron やラベル変更で自動的にエージェントが動く仕組みは標準機能として提供されていません。ドキュメントワーカーの定期業務を自動化したいケースで、Craft Agents 独自の強みになります。
Permission Modes（3 段階の権限モデル）
エージェントによる誤操作を防ぐため、権限モードが 3 段階で用意されています。
- Explore: 読み取り専用
- Ask to Edit: 変更操作時に人間の承認を要求（デフォルト）
- Auto: 自動承認
SHIFT+TAB での切り替えが用意されており、PoC 検証中は Ask to Edit、本番自動化は Auto、と場面で切り替える運用が想定されています。
アーキテクチャと技術スタック
「導入時にどれだけの技術負債・依存関係を抱えることになるか」は、初見の意思決定で最も気になる論点の一つです。ここでは Monorepo 構成・技術スタック・バックエンド構造・認証情報の扱いを整理します。
モノレポ構成とディレクトリレイアウト
README の Architecture セクション（craft-ai-agents/craft-agents-oss）で示されているとおり、Craft Agents は Bun をランタイムとする TypeScript の Monorepo として構成されています。README から引用したディレクトリ構造は以下のとおりです。
craft-agent/
├── apps/
│ ├── cli/ # ターミナルクライアント（craft-cli）
│ └── electron/ # デスクトップ GUI（プライマリ）
│ └── src/{main,preload,renderer}
└── packages/
├── core/ # 共有型定義
└── shared/ # ビジネスロジック
└── src/{agent,auth,config,credentials,sessions,sources,statuses}
出典: craft-ai-agents/craft-agents-oss README
apps/electron がプライマリのデスクトップアプリ、apps/cli がスクリプト連携用の CLI クライアントで、共通のビジネスロジックは packages/shared に集約されている構成です。
技術スタック一覧
主要な技術スタックは以下の通りです。
レイヤ | 採用技術 |
|---|---|
ランタイム | Bun |
Claude backend | @anthropic-ai/claude-agent-sdk |
Pi backend | Pi SDK agent server |
デスクトップ | Electron + React |
UI | shadcn/ui + Tailwind CSS v4 |
ビルド | esbuild（main）+ Vite（renderer） |
認証情報 | AES-256-GCM 暗号化ファイルストレージ |
Electron + React + shadcn/ui + Tailwind v4 は現在のデスクトップアプリ開発の定番構成に近く、既存 UI コンポーネントの流用や独自拡張の余地がある点は、社内フォークして機能追加したい企業にとってプラスに働きます。
デュアルバックエンド（Claude / Pi）とプロバイダールーティング
Craft Agents の目立った特徴の一つが デュアルバックエンド です。README の記載を要約すると、対応プロバイダーは接続経路によって次のように分かれます。
- Claude backend（Anthropic 互換系）: Anthropic API key / Claude Max・Pro OAuth / OpenRouter / Vercel AI Gateway / Ollama など
- Pi backend（Google／OpenAI系）: Google AI Studio / ChatGPT Plus（Codex OAuth） / GitHub Copilot OAuth / OpenAI API key
「Claude で書かせて、要約は Gemini、社内ドキュメント検索は Copilot」といった プロバイダーの併用を単一アプリで完結 させたい場合、この構造は要件を素直に満たします。
認証情報の格納と MCP 隔離
認証情報はローカルに AES-256-GCM で暗号化して保存 されます。設定・データは ~/.craft-agent/ 配下に集約される構成で、ワークスペースごとに automations.json / sessions/ / sources/ / skills/ などが管理されます。
セキュリティ面では、ローカル MCP サーバーを stdio 経由で起動する際、ANTHROPIC_API_KEY / CLAUDE_CODE_OAUTH_TOKEN / AWS_* / GITHUB_TOKEN / OPENAI_API_KEY / GOOGLE_API_KEY / STRIPE_SECRET_KEY / NPM_TOKEN などの機密環境変数を自動でフィルタする挙動が README に明記されています。MCP プロセスから機密情報が意図せず漏れることを避ける設計です。
導入とセットアップの流れ
Craft Agents は、デスクトップアプリ・Headless サーバー・CLI クライアントの 3 系統の提供形態を持ちます。用途に応じた導入手段が用意されているため、PoC と本番運用で構成を切り替えられます。
デスクトップアプリのインストール
公式ドキュメント Getting Started - Introduction で案内されているワンライナーインストールを、README の抜粋のかたちで示します。
# macOS / Linux
curl -fsSL https://agents.craft.do/install-app.sh | bash
出典: craft-ai-agents/craft-agents-oss README
Windows 環境向けには PowerShell 経由のインストーラー（irm https://agents.craft.do/install-app.ps1 | iex）も同 README に記載されています。ソースビルドを行う場合は Bun をランタイムとして bun install → bun run electron:start で起動する流れです。
クイックスタート 5 ステップ
公式ドキュメントおよび README の Quick Start では、初回セットアップの標準フローが次のように整理されています。
- アプリを起動する
- LLM 接続を選択する（Anthropic / Google / OpenAI など）
- ワークスペースを作成する
- Sources を接続する（任意。Google Drive・Slack・ローカル FS など）
- セッションを開始する
設定ファイルの記述やウィザードでの初期化を最小限に抑え、プロンプトから追加のセットアップを進めていく思想が反映されたステップ構成です。
Headless サーバーモードと thin-client
Craft Agents の運用形態として、デスクトップアプリを thin-client として使いつつ、実処理を別マシンの Headless サーバーで走らせる構成もサポートされています。README で言及されている主な環境変数は以下です。
CRAFT_SERVER_TOKEN（必須・Bearer トークン）CRAFT_RPC_HOST/CRAFT_RPC_PORT（既定 9100）CRAFT_RPC_TLS_CERTほか TLS 用設定
TLS 自己署名証明書生成用スクリプトも同梱されており、本番運用ではリバースプロキシや Let's Encrypt との組み合わせが推奨されています。長時間バッチ・複数マシンからのアクセス・計算集約ワークロードをローカル PC から切り離したい場合の受け皿として機能します。
CLI クライアント（craft-cli）の使い分け
apps/cli に含まれる craft-cli は WebSocket 経由でサーバーに接続する CLI で、スクリプト・CI/CD・サーバー検証・ターミナル操作向けに用意されています。主要コマンドは ping / health / workspaces / sessions / send / run / --validate-server などで、run サブコマンドはサーバー起動からセッション作成、プロンプト送信、応答ストリーム、終了までを自己完結で扱えます。
まとめると、PoC は Electron デスクトップアプリ、CI/CD 連携は CLI、常時運用は Headless サーバーという 3 モードの使い分けが可能です。
類似 OSS との違い
初見エンジニアが最も気になるのは「Cline や LibreChat、Emdash と何が違うのか」という点でしょう。ここでは類似 OSS 3 プロダクトとの差分を整理します。
Emdash との違い
generalaction/emdash（Emdash）は Y Combinator W26 バッチに採択された Electron 製デスクトップアプリで、31 種の CLI コーディングエージェント（Claude Code / Codex / Gemini CLI / Cursor / Goose 等）を並行実行するオーケストレーターです。Git worktree ベースで各タスクを隔離し、差分レビュー・マージを支援します。
これに対し Craft Agents は、Claude Agent SDK / Pi SDK を GUI から直接呼び出す 統合デスクトップ体験 を提供するもので、「CLI エージェントのオーケストレーション」ではなく「ドキュメント中心の統合セッション管理」に軸足があります。
LibreChat との違い
danny-avila/LibreChat はセルフホスト型の Web ベース マルチプロバイダーチャット UI です。マルチユーザー認証、Agents カスタム作成、MCP、Artifacts、Code Interpreter、DALL-E 3 まで揃った Web IDE 的な位置付けで、ブラウザで完結する運用が前提です。
Craft Agents は デスクトップネイティブ（Electron）でシングルユーザー を前提とし、ドキュメント／セッション管理（Inbox・Automations・Multi-File Diff）とローカル環境との統合が中核です。ヘッドレスサーバーモードで長時間ワークロードを分離できる点は共通しますが、UI の提供形態と多人数運用要件がかみ合うかどうかで選択が分かれます。
Cline との違い（補足）
cline/cline は VS Code 拡張として提供される自律コーディングエージェントで、エディタ内完結型のワークフローを提供します。Craft Agents は独立したデスクトップアプリで、コード編集を主目的とせず、非エディタ・非 CLI のドキュメントワーカー も対象に含めている点が思想として異なります。
比較まとめ（用途別マトリクス）
用途 | 推奨候補 | 補足 |
|---|---|---|
VS Code 内で自律コーディングを完結させたい | Cline | エディタ拡張として最短距離 |
複数の CLI コーディングエージェントを並列オーケストレーションしたい | Emdash | Git worktree 分離が中核 |
ブラウザで社内メンバー複数人が使うマルチプロバイダーチャット | LibreChat | Web／マルチユーザー |
ドキュメント業務中心で、Inbox・Automations で常時運用したい | Craft Agents | デスクトップ／シングルユーザー |
想定ユースケースと採用判断のポイント
裏テーマである「自プロジェクトに採用すべきか」に直接答える章です。Craft Agents が向いているケースと見送るべきケースを、判断チェックリスト付きで整理します。
向いているユースケース
- 非エンジニアも含む社内ドキュメントワークフローに AI エージェントを組み込みたいです
- ラベル変更や cron を起点にした定期業務の自動化を 自然言語で構成 したいです
- Headless サーバーで長時間バッチを走らせつつ、複数拠点のクライアントから接続したいです
- Claude Agent SDK と Google/OpenAI 系プロバイダーを 単一アプリ内で切り替えて使いたいです
採用判断チェックリスト
以下を YES で埋められる項目が多いほど、Craft Agents が候補になる可能性が高くなります。
- コードだけでなくドキュメント作成・編集を主要ユースケースに含むか
- 複数の LLM プロバイダーをワークスペース単位で切り替える必要があるか
- cron／ラベル／イベント駆動での自動セッション生成を業務要件として持つか
- リモートサーバーでの常駐実行が必要か（PC を閉じても続けたいバッチがあるか）
- AES-256-GCM ローカル暗号化・MCP プロセスの環境変数隔離といったローカル運用前提のセキュリティ設計が要件に合うか
見送るべきケース
- VS Code 内で完結させたいです（Cline のほうが摩擦が少ない）
- CLI コーディングエージェントの並列オーケストレーションが目的（Emdash が第一候補）
- Web ベースでマルチユーザー運用が必須（LibreChat のほうが要件に近い）
このように「エディタ拡張／CLI 並列／Web マルチユーザー」で足りるなら、Craft Agents を無理に採用する必要はありません。
ライセンス・メンテナンス状況・注意点
商用導入や社内標準化を判断する上で、ライセンス条件とメンテナンス指標は必ず確認する項目です。
ライセンスと商標
Craft Agents は Apache License 2.0 で公開されており、商用利用・改変・再配布が可能です。
同時に、README や TRADEMARK.md で明示されているとおり、「Craft」および「Craft Agents」は Craft Docs Ltd. の商標です。フォークして別名で公開する場合や、ロゴ・ブランド名を製品名として使う場合には TRADEMARK.md の条件に従う必要があります。
また、Claude Agent SDK を利用する部分については、Anthropic の Commercial Terms of Service が別途適用されます。Apache-2.0 が付いているからといって、Claude Agent SDK 側の商用契約条件が上書きされるわけではない 点は押さえておくべきです。
リポジトリのメンテナンス指標
先に示した通り、GitHub 側の公開状態から確認できるメンテナンス指標は以下です。
- スター数 6,654 / フォーク 917
- 主要言語 TypeScript / ライセンス Apache-2.0
- 最終 push は 2026-07-01 と直近
archived=false/fork=false/disabled=false
数値上は「アクティブに開発が継続されており、フォーク版でもアーカイブ済みでもない現行リポジトリ」と判断できます。ただし OSS 選定の一般原則として、Issue・Pull Request のマージ頻度、リリースノートの更新頻度、コアメンテナ数などは、README を読んだ後に GitHub リポジトリで直接確認することを推奨します。
セキュリティ設計
セキュリティ面については前述のとおり、ローカル MCP サーバー起動時の環境変数フィルタと、認証情報の AES-256-GCM 暗号化が README に明記されています。加えて SECURITY.md に脆弱性報告手順が用意されており、脆弱性発見時の連絡窓口が明示されている点も、社内標準として採用する際の判断材料になります。
まとめ
本記事では、Craft Agents（craft-ai-agents/craft-agents-oss） について、リポジトリメタデータと公式ドキュメントをもとに整理しました。要点をまとめると次のようになります。
- 位置付け: Claude Agent SDK + Pi SDK をデュアルバックエンドで束ね、ドキュメント中心のワークフローを支えるデスクトップ AI エージェント OSS
- 強み: Multi-Session Inbox・Automations（イベント駆動自動化）・プロンプト駆動の Sources 追加・Headless サーバー分離・AES-256-GCM 暗号化ローカル認証情報・MCP 環境変数フィルタ
- 類似 OSS との棲み分け: Cline（VS Code 内自律コーディング）、Emdash（CLI エージェント並列）、LibreChat（Web マルチユーザー）とは守備範囲が異なる
- ライセンスとメンテナンス: Apache-2.0（archived=false / fork=false）、直近も push 更新あり。Claude Agent SDK 部分は Anthropic の商用条件が別途適用される点に留意
初見エンジニアとしての次の一歩としては、以下の順で進めるとムダが少ないはずです。
- まず 公式サイト と Automations Overview で、ドキュメント中心ワークフローの世界観が自社課題に合うかを確認する
- デスクトップアプリで、既存の Anthropic / OpenAI キーを使った単発検証を行い、Inbox・Sources・Automations の運用感を掴む
- 「PC を閉じても走らせたいバッチ」が具体化した段階で、Headless サーバーモードでの常時運用に切り替える
「Cline や LibreChat で十分か、Craft Agents に踏み込む価値があるか」の判断軸として、本記事が意思決定の下敷きになれば幸いです。
