CoreStudio Agent 集成

在你的 Agent 中使用 CoreStudio

CoreStudio 会从 Mac 上已签名的本机应用包安装一个宿主 Skill 和一份共享 CLI。选择你使用的 Agent，然后在“应用设置 → Agent 集成”中完成安装。

官网只负责说明流程，不会检测你的 Mac，也不会执行安装。
Skill
Codex、Cursor、Claude Code 分别安装
CLI
只安装一次，三种受支持宿主共用
连接
本机 CoreStudio 与 Local Bridge

一次安装 Skill 与 CLI

不要下载 Skill 压缩包，也不要运行网络安装脚本。CoreStudio 使用已签名应用内自带的集成资源。

  1. 安装并打开 CoreStudio

    尚未安装时，从 GitHub 下载最新签名 macOS 版本。连接验证期间保持 CoreStudio 正在运行。

    下载最新版本

  2. 打开 Agent 集成设置

    在 CoreStudio 中打开“应用设置 → Agent 集成”。官网无法替你打开或检测这个本机页面。

  3. 安装 Codex

    点击安装、更新或修复。CoreStudio 会在同一个受管操作中准备宿主 Skill 和共享 CLI。

    ~/.codex/skills/corestudio/

  4. 新建 Agent 对话

    已经打开的对话可能不会重新扫描刚安装的 Skill。首次使用前请新建一个本地对话。

先验证安装，再验证项目连接

安装完整与项目可连接是两个不同层级。先检查版本，再检查正在运行的 CoreStudio。

1. 安装完整性

这个命令不要求当前已经打开项目，也不要求 Local Bridge 可达。

corestudio --version --json

2. 本地连接

打开 CoreStudio 后再运行。它只报告 Bridge 与当前项目状态，不会修改项目。

corestudio read status --json

从一条自然语言任务开始

新建一个本地 Agent 对话，让宿主重新发现 Skill，然后让它打开当前 CoreStudio 项目。

打开当前 CoreStudio 项目，读取画布与选区，并告诉我当前可以继续做什么。

Codex 可以自动建立兼容的本地身份，不需要你复制或保存 session 引用。

CLI 常用任务

这里提供按任务组织的入口，不复制完整命令合同。Agent 调用应保留 JSON 输出，完整参数以原始合同为准。

检查状态

corestudio read status --json

读取选区

corestudio read selection --json

打开 Agent Board

corestudio read board-url --json

写回图片

corestudio write image /absolute/path/result.png --source-type generated --origin agent-board --json

写回流程图

corestudio write diagram --format mermaid --file /absolute/path/process.mmd --anchor auto --json
打开完整 CLI 合同

先定位现象，不连续叠加修复

找到与当前现象匹配的一项，执行最短恢复路径，再验证一次后决定是否继续。

查看原始文档