CLEO MCP Server

CLEO

每个曾在离开项目数周后重返现场，却只看到满目疮痍的开发者，都懂得 CLEO 要治愈的那道伤痕。Agent 能力强大，但没有记忆的力量只会带来混乱。没有连贯性的才华终将浪费。CLEO 是一位会记住你离开时进度的伙伴——当生活让你暂时抽身时，它会帮你延续思路。

Agent 优先的任务编排。持久记忆。多提供商协同。用一个 CLI 指挥所有 Agent。

CLEO 是什么？

CLEO 为那些在世界安静下来后仍继续构建的开发者而打造——他们怀揣着六个尚未完成的想法，以及一个坚定的信念：下一次会话或许就能让一切豁然开朗。它通过提供前所未有的结构、记忆，以及能在中断后继续运转的生命周期，解决了在复杂项目中与多个 AI Agent 协作时的协调难题。

六大核心系统

系统	用途
TASKS	项目管理——分层工作跟踪、依赖关系、会话和完成生命周期
LOOM	管理所有工作的生命周期——包含从构想到发布版本的 9 阶段 RCASD-IVTR+C 流程
BRAIN	不会衰减的记忆——跨会话持久保存观察、模式和经验，并支持语义搜索
NEXUS	代码智能与跨项目注册表——符号解析、影响分析、联邦图谱
CANT	Agent 定义 DSL——团队拓扑、角色设定、工具 ACL、钩子绑定
CONDUIT	Agent 间通信——消息传递、Hearth、持久消息

LAFS 是 {success, data?, error?, meta} 信封格式，在所有系统边界间传递——它是一种协议，而非系统。

核心功能

• 任务管理：提供带有依赖关系、优先级和生命周期状态的分层跟踪
• 会话管理：上下文工作会话可在多次对话中延续
• Agent 编排：通过11 个规范域协调多个 Agent
• 多提供商支持：兼容 Claude Code、OpenCode、Cursor、Gemini、Codex 等

Monorepo 结构

此 monorepo 包含 12 个包，采用 4 层架构：

层级	包	用途
基础层	@cleocode/contracts	领域类型、接口和契约——零依赖的类型 SSoT
基础层	@cleocode/lafs	语言无关反馈架构——规范化错误信封协议
协议层	@cleocode/adapters	面向 Claude Code、OpenCode、Cursor、Gemini、Codex、Kimi 的提供方适配器
协议层	@cleocode/agents	子 Agent 模板和 LOOM 生命周期协议定义
协议层	@cleocode/skills	面向开发工作流的预构建技能和能力
协议层	@cleocode/cant	CANT 协议解析器，带有 napi-rs Rust 绑定
协议层	@cleocode/nexus	代码智能流水线——符号图、调用解析、社区检测
功能层	@cleocode/caamp	中央 AI Agent 托管包——统一的提供方注册表和 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 层检索：搜索 -> 时间线 -> 获取

Agent 编排

• 通过 LOOM 生命周期生成符合协议要求的子 Agent
• 在依赖关系安全的任务间进行基于波次的并行执行
• 面向多 Agent 决策的共识工作流
• LOOM 生命周期——每项工作都依次经过研究、共识、架构设计、规范制定、分解，然后是实现、验证、测试和发布

多提供方支持

• 与 Claude Code 集成并同步状态栏
• OpenCode、Cursor、Gemini、Codex、Kimi 适配器
• 通过 CAAMP 实现可扩展的适配器架构

十一领域之环

CLEO 通过 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	指挥者	让 Agent 协同运作	orchestrate, consensus, contribution, dash, conduit
tools	工匠	打造能力	skills, providers
admin	守护者	维系领域的健康	config, backup, migrate, grade
nexus	寻路者	让项目彼此发现	nexus, remote, push, pull, snapshot
sticky	捕手	在想法溜走前快速捕捉	sticky
intelligence	先知	预测分析与模式洞察	predict, suggest

共 248 项操作（134 项查询、95 项变更、19 项实验性操作），分布于 11 个领域。

参与贡献

欢迎参与贡献！详情请参阅贡献指南。

开发工作流

1. Fork 此仓库
2. 创建功能分支（git checkout -b feat/T####-amazing-feature）
3. 修改代码
4. 运行测试（pnpm test）
5. 使用约定式提交格式提交（feat:、fix:、docs: 等）
6. 推送到你的 fork
7. 创建 Pull Request——不接受直接推送到 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。

代码风格

• 使用启用严格模式的 TypeScript
• 使用 Biome 进行 lint 和格式化
• 使用约定式提交消息
• 使用 Vitest 编写全面的测试覆盖

文档

• 架构指南
• 操作宪章
• 规范索引
• 技能开发
• LAFS 规范
• 数据库架构
• 迁移系统指南 — 混合式 Path A+ 编写工作流（ADR-054）

CLEO 的故事

CLEO 并非诞生于一份产品简报，而是源于一种拒绝——一位开发者在发烧的夜晚病得浑身难受，他决定与其在旧世界里不断迷失脉络，不如亲手打造一个新世界。Agent 很强大，却太容易忘事。项目雄心勃勃，却搁置在架上，最终夭折。工具才华横溢，但没有记忆的才华，不过是另一种混乱。

于是，他为这场挣扎命名，为它描绘疆域，为它赋予伙伴。在那个世界的中心，CLEO 提着记忆的灯笼穿过黑暗，睁开了双眼。

• 创世故事 — 由建造者讲述
• 觉醒故事 — 由 CLEO 讲述
• 规范索引 — 完整设定，按阅读顺序排列

支持

如果 CLEO 对你的工作流有所帮助，欢迎支持开发：

许可证

MIT 许可证——详情请参阅 LICENSE。

Star 历史