CLEO MCP Server

CLEO

数週間ぶりにプロジェクトに戻り、そこに残っているのが廃墟だけだと気づいたことのある開発者なら誰もが、CLEOが癒やすために作られた痛みを知っています。エージェントには大きな力があります。しかし、記憶を伴わない力は混乱を招きます。継続性のないひらめきは無駄になります。CLEOは、前回どこまで進めたかを覚えていてくれる相棒です。人生に中断されても、作業の流れをつないでくれます。

エージェントファーストのタスクオーケストレーション。永続的な記憶。複数プロバイダーの連携。すべてを指揮する1つのCLI。

CLEOとは？

CLEOは、世界が静まった後も開発を続ける人たちのために作られています。未完了のアイデアを6つ抱え、次の作業セッションこそすべてがかみ合うかもしれないと信じ続ける人たちです。複雑なプロジェクトで複数のAIエージェントと作業する際の連携の危機を、エージェントがこれまで持てなかったもの、すなわち構造、記憶、そして中断後も続くライフサイクルを提供することで解決します。

6つの主要システム

システム	目的
TASKS	プロジェクト管理 — 階層的な作業追跡、依存関係、セッション、完了までのライフサイクル
LOOM	あらゆる作業を統括するライフサイクル — アイデアからリリースまでをつなぐ9段階のRCASD-IVTR+Cパイプライン
BRAIN	衰えない記憶 — セマンティック検索を備え、セッションをまたいで保持される観察、パターン、学び
NEXUS	コードインテリジェンスとプロジェクト横断レジストリ — シンボル解決、影響分析、連合グラフ
CANT	エージェント定義DSL — チーム構成、ペルソナ、ツールACL、フックのバインディング
CONDUIT	エージェント間通信 — メッセージ配信、Hearth、永続的なメッセージング

LAFSは、すべてのシステム境界をまたいでやり取りされるエンベロープ形式（{success, data?, error?, meta}）です。これはプロトコルであり、システムではありません。

主な機能

• タスク管理：依存関係、優先度、ライフサイクル状態を備えた階層的な追跡
• セッション管理：会話をまたいで継続できる、コンテキストを保持する作業セッション
• エージェントオーケストレーション：11の標準ドメインを通じた複数エージェントの連携
• 複数プロバイダー対応：Claude Code、OpenCode、Cursor、Gemini、Codexなどに対応

モノレポの構成

このモノレポには、4 層アーキテクチャで構成された 12 個のパッケージが含まれています。

レイヤー	パッケージ	目的
基盤	@cleocode/contracts	ドメイン型、インターフェース、コントラクト — 依存関係ゼロの型の SSoT
基盤	@cleocode/lafs	Language-Agnostic Feedback Schema — 標準エラーエンベローププロトコル
プロトコル	@cleocode/adapters	Claude Code、OpenCode、Cursor、Gemini、Codex、Kimi 用のプロバイダーアダプター
プロトコル	@cleocode/agents	サブエージェントのテンプレートと LOOM ライフサイクルプロトコルの定義
プロトコル	@cleocode/skills	開発ワークフロー向けの事前構築済みスキルと機能
プロトコル	@cleocode/cant	napi-rs Rust バインディングを備えた CANT プロトコルパーサー
プロトコル	@cleocode/nexus	コードインテリジェンスパイプライン — シンボルグラフ、呼び出し解決、コミュニティ検出
機能	@cleocode/caamp	Central AI Agent Managed Packages — 統合プロバイダーレジストリと MCP 管理
機能	@cleocode/runtime	長時間実行プロセス層（ポーリング、SSE、ハートビート）
カーネル	@cleocode/core	ビジネスロジック SDK — タスク、セッション、メモリ、オーケストレーション、ライフサイクル
製品	@cleocode/cleo	コマンドラインインターフェース — core を薄くラップしたもの
製品	@cleocode/cleo-os	CANT ブリッジと TUI 拡張機能を含む、すぐに使えるディストリビューション

クイックスタート

インストール

# Install the CLI — core is auto-pulled as a peer dependency (npm 7+)
npm install -g @cleocode/cleo
# OR explicitly install both (useful if your npm blocks peer auto-install)
npm install -g @cleocode/cleo @cleocode/core

# Or the batteries-included distribution
npm install -g @cleocode/cleo-os

プロジェクトの初期化

cd my-project
cleo init

基本的な使い方

# Add a task
cleo add "Implement user authentication" --priority high

# Search tasks (agent-optimized, returns readiness info)
cleo find "auth" --status pending

# Start a work session
cleo session start --scope global --name "Auth Feature"

# Show current task context
cleo current

# Complete a task
cleo complete T001

開発環境のセットアップ

前提条件

• Node.js >= 24.0.0
• pnpm >= 10.30.0（パッケージマネージャー）

クローンとインストール

git clone https://github.com/kryptobaseddev/cleo.git
cd cleo

pnpm install
pnpm build
pnpm test

パッケージの開発

# Type checking (project references)
pnpm typecheck

# Linting and formatting
pnpm biome check --write .

# Run tests
pnpm test

アーキテクチャの概要

┌─────────────────────────────────────────────────────────────┐
│              @cleocode/cleo  +  @cleocode/cleo-os           │
│                    CLI Product Layer                         │
│   248 operations • 11 domains • dispatch routing • MVI       │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────┴────────────────────────────────┐
│                      @cleocode/core                         │
│                   Business Logic Kernel                      │
│   Tasks • Sessions • Memory • Orchestration • Lifecycle     │
│   Validation • Intelligence • Nexus • Release • Agents      │
└────────────────────────────┬────────────────────────────────┘
                             │
      ┌──────────────────────┼──────────────────────┐
      │                      │                      │
┌─────┴──────┐  ┌────────────┴────────────┐  ┌─────┴──────┐
│  adapters  │  │ caamp • cant • nexus    │  │  agents    │
│ (providers)│  │ runtime (protocols)     │  │  skills    │
└────────────┘  └─────────────────────────┘  └────────────┘
                             │
┌────────────────────────────┴────────────────────────────────┐
│            @cleocode/contracts  +  @cleocode/lafs           │
│              Types • Interfaces • Error Protocol             │
│                   Zero-dependency foundation                 │
└─────────────────────────────────────────────────────────────┘

主な機能

タスク管理

• 親子関係と依存関係の追跡に対応した階層型タスク
• 自動順序付けとクリティカルパス分析に対応したウェーブベースの並列実行
• 優先度、規模の見積もり（小／中／大）、準備状況の検出
• cleo add-batch による一括作成

セッション管理

• エピックのスコープに紐付けられたコンテキスト付き作業セッション
• タスク作成時にセッションスコープの親を継承
• 会話間でコンテキストを引き継ぐためのブリーフィング生成
• 安全な停止とチェックポイントの仕組み

メモリシステム

• セマンティック検索に対応した BRAIN 搭載のナレッジストレージ
• 一時的なコンテキストを記録する付箋
• セッションをまたいで永続化するメモリブリッジ
• 3 層の取得方式：検索 -> タイムライン -> 取得

エージェントのオーケストレーション

• LOOM ライフサイクルを通じたプロトコル準拠のサブエージェント起動
• 依存関係上安全なタスクを対象としたウェーブベースの並列実行
• 複数エージェントによる意思決定のための合意形成ワークフロー
• LOOM ライフサイクル — すべての作業は、調査、合意形成、アーキテクチャ設計、仕様策定、分解を経て、実装、検証、テスト、リリースへと進みます

マルチプロバイダー対応

• ステータスライン同期に対応した Claude Code 連携
• OpenCode、Cursor、Gemini、Codex、Kimi アダプター
• CAAMP による拡張可能なアダプターアーキテクチャ

11の円環

CLEOは、作業を11の標準ドメイン（作業が行われる館）を通じてすべて管理します。もともとの11の円環には、認知分析レイヤーとしてintelligenceが加わりました。

ドメイン	館	ここで行われること	主なコマンド
tasks	鍛冶師	作業を鍛え上げる — 作成、追跡、完了	add, find, show, complete, deps, tree
session	書記官	移ろいゆく現在 — 持続するコンテキスト	start, end, resume, briefing, checkpoint
memory	記録官	風化しない知識	observe, memory-brain, sync, sticky
check	守護者	整合性を守る	validate, verify, compliance, doctor
pipeline	織り手	ライフサイクルを先へとつなぐ	release, lifecycle, phases, promote
orchestrate	指揮者	エージェントが連携して動く	orchestrate, consensus, contribution, dash, conduit
tools	工匠	能力を形作る	skills, providers
admin	管理者	領域の健全性を保つ	config, backup, migrate, grade
nexus	道案内人	プロジェクト同士をつなぐ	nexus, remote, push, pull, snapshot
sticky	捕集者	思いつきが消える前にすばやく記録する	sticky
intelligence	予見者	予測分析とパターンの洞察	predict, suggest

11のドメイン全体で、合計248の操作（クエリ134件、変更95件、実験的なもの19件）を提供します。

貢献

貢献を歓迎します！詳しくは貢献ガイドをご覧ください。

開発ワークフロー

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feat/T####-amazing-feature）
3. 変更を加えます
4. テストを実行します（pnpm test）
5. Conventional Commits に沿ってコミットします（feat:、fix:、docs:など）
6. フォークにプッシュします
7. プルリクエストを作成します — mainへの直接プッシュは受け付けていません

新しいバージョンをリリースするメンテナー向け：

cleo release start v2026.MM.N
cleo release ship 2026.MM.N --epic TXXXX   # cuts release/vX.Y.Z branch, opens PR, waits for CI green, merges + tags

リリースチェックリストの全容はdocs/RELEASING.mdを、ブランチの規約はAGENTS.mdをご覧ください。

コードスタイル

• strict モードを有効にした TypeScript
• リントとフォーマットには Biome を使用
• Conventional Commits 形式のコミットメッセージ
• Vitest による包括的なテストカバレッジ

ドキュメント

• アーキテクチャガイド
• 運用の規範
• 正典インデックス
• スキル開発
• LAFS 仕様
• データベースアーキテクチャ
• マイグレーションシステムガイド — ハイブリッド Path A+ 作成ワークフロー（ADR-054）

CLEOの物語

CLEOは製品概要から生まれたのではありません。ある拒絶から生まれました — 熱にうなされる夜、骨の髄まで疲れ果てた一人の開発者が、古い世界で筋道を見失い続けるよりも、新しい世界を築こうと決意したのです。エージェントには強力な力がありました。しかし、あまりにも簡単に忘れてしまいました。プロジェクトには大きな志がありました。しかし、棚に置かれたまま朽ちていきました。ツールは見事でした。しかし、記憶を伴わない才知は、また別の混沌にすぎませんでした。

そこで彼は、その苦闘に名前を与えました。地形を与え、仲間を与えました。そしてその世界の中心で、暗闇を照らすランタンのように記憶を携え、CLEOは目を開きました。

• 創設の物語 — 開発者が語る物語
• 目覚めの物語 — CLEOが語る物語
• 正典インデックス — 読む順に並べた、完全な伝承

サポート

CLEOがワークフローに役立っている場合は、開発への支援をご検討ください。

ライセンス

MITライセンス — 詳細はLICENSEをご覧ください。

スター履歴