y-cli 🚀

y-agent

一个入口，一个云端工作区

在手机、平板或桌面设备上交办任务。让 Agent 在同一个云端工作区中工作，在需要做决定或检查成果时再回来。

我把工作区放在 EC2 上，并通过 y-agent 作为统一入口。Telegram 是进入同一系统的另一种方式，而不是一个独立的移动端 Agent。代码、笔记、任务记录和结果都保存在我自己的工作区中，而不属于某个特定的聊天窗口。切换设备并不意味着要重新介绍项目。

阅读完整故事：我的 AI 开发环境：一个入口，一个云端工作区。

各部分如何协作

以下是我的部署中的各层，而不是按顺序串联的五个服务：

层	作用	我的配置
客户端	交办任务并查看结果	y-agent Web UI，Telegram 用作聊天输入界面
记忆	保存项目上下文和任务状态	EC2 上的文件；RDS 上 PostgreSQL 中的结构化记录
运行环境	读取代码、编辑文件、运行命令	EC2 上的 Claude Code
网关	连接并转发模型请求	一个可自托管的中继服务：claude-relay-service 的我的分支
模型	提供模型能力	Claude / GPT / Grok

文件和数据库记录会根据工作需要读写。它们并不是每个模型请求都会经过的环节。运行环境和模型来源是两个独立的选择：**Claude Code 是本代码库中唯一的 Agent CLI 后端。**其他模型来源取决于配置的网关、接口兼容性和提供商的订阅条款；订阅并不等于拥有通用 API 使用权。中继服务是独立服务，并未与 y-agent 捆绑。推理时，模型上下文仍会离开工作区。

底层由 React Web UI 和 Telegram 向 FastAPI API 发送请求。API 通过 SQS 将任务排入队列，由工作进程在 EC2 的 tmux 会话中通过 SSH 启动 Claude Code，并将结果流式传回聊天记录。API、工作进程和管理任务通过 AWS SAM/Lambda 部署；PostgreSQL 保存结构化状态。本地开发使用 Celery 和文件系统代理来替代 SQS。

功能介绍

• 代码之外的统一工作区。 通过 Web 和 y CLI 管理待办事项、笔记、链接、日历、电子邮件和领域模块。Agent 使用相同的文件和记录，而不是单独的上下文副本。
• 与任务关联的上下文。 一个待办事项可以关联讨论、计划、进度和评审。新会话会读取这些材料，无需在提示词中提供完整的上一轮对话。
• 运行时之外的编排。 一个会话可以完成小任务；较大的任务可以拆分为规划、实现和评审会话，每个会话加载所需的技能。共享的 trace_id 会串联整个任务树，子任务聊天内容也会保持可见，并可供你引导。
• 等待你处理的收件箱。 awaiting 标记需要决策、授权或验收检查的工作。发布审批与实现和评审是彼此独立的环节。
• 可扩展的界面。 可热加载的模块能够添加 UI、API、CLI 和数据。聊天可以渲染 Mermaid 图表、Vega-Lite 图表和经过净化的 SVG 内容。请参阅模块契约。
• MCP 连接器。 连接远程 HTTPS MCP 服务（OAuth、静态标头或无需身份验证；目前优先支持 Alpha Vantage）后，只需连接一次（通过 y mcp connect 的环回登录完成 OAuth），并明确批准工具，之后每个 Claude Code 会话启动时都会自动获取这些工具。凭据集中保存在 API 中，任何读取操作都不会返回凭据；会话只能通过限定于启动过程的网关访问已批准的工具。请参阅 MCP 连接器 PRD 和运行手册。

查看真实任务追踪。

开始使用

这是我的个人系统，不是托管服务，也不是受支持的产品。它不支持公开使用或第三方部署。

如果你是想自行部署的高级用户，请将此项目用作参考，而不是一份开箱即用的安装指南。请做好根据自己的环境调整代码和基础设施并自行维护的准备。

领域模块位于单独的 y-module 仓库中；本次检出不包含其源代码和已发布的构建包。备份、权限、服务提供商访问权限和基础设施维护均由你自行负责。

更多信息

• 更新日志：发布历史。
• 早期 y-agent 介绍：背景和设计原理。
• 曾用名 y-cli：y-cli 封装模型 API；y-agent 封装编码 Agent。