Chimera

August 8, 2026 · View on GitHub

Chimera logo

Chimera

English | 简体中文

Chimera 是一个 AI 编程 Agent 发行版：一个 opencode-derived 的交互式 CLI，加上内置的 Chimera/CodeGraph 图谱与传播审计运行时。

公开的包名和命令名都是 chimera。图谱/运行时命令归属于同一个 CLI；本发行版不提供公开的 opencode 或 codegraph bin。

包身份

  • 完整 Agent 包源码：packages/chimera
  • npm 包名：@coding-chimera/chimera
  • 公开 CLI 命令：chimera
  • 图谱命令入口：chimera graph ... 和 chimera --graph ...

当本仓库提及原始项目时，会明确使用 upstream opencode 或 original opencode。

设计渊源与参考

Chimera 这个名字是有意而为之：这个项目将多套 agent 与图谱运行时系统的优势融合进一个发行版，同时保持公开包名和命令名均为 chimera。

Chimera 致谢并引用以下设计参考：

  • upstream opencode 提供交互式 coding-agent 底座和 CLI runtime 血统。
  • Kimi Code 为 Kimi 导向行为提供参考，包括针对 Kimi 模型的 provider 专用 prompt、工具、搜索与认证考量。
  • Codex 为 OpenAI/Codex/GPT 导向行为提供参考，包括上下文纪律和直接 Responses/OAuth 集成模式。
  • CodeGraph 提供仓库图谱和语义证据底座，支撑 Chimera 的影响分析与传播审计方向。
  • OpenCodeUI 提供基于 Web 的用户界面（packages/newweb），该组件以 GPL-3.0 许可发布。

这些引用描述的是架构血统和实现影响。Chimera 不自称为 upstream opencode、Kimi Code、Codex 或 CodeGraph；它是在这些系统基础之上构建并受其启发的 Chimera 发行版。

安装与运行

Chimera 已发布到 npm registry，包名为 @coding-chimera/chimera：

npm install -g @coding-chimera/chimera
chimera --version

也可以从 GitHub Releases 下载最新 release tarball，通过 npm 安装。

选择 no-webui（MIT）或 with-webui（整体标记为 GPL-3.0-only，并单独保留 MIT runtime 许可）变体。两种变体使用相同的 @coding-chimera/chimera 与 @coding-chimera/chimera-<platform> npm 包身份，因此一次只能安装一种变体。 查看 releases 页面获取最新版本号和准确的 tarball 文件名。

npm install -g ./coding-chimera-chimera-darwin-arm64-no-webui-0.0.5-patch1.tgz ./coding-chimera-chimera-no-webui-0.0.5-patch1.tgz
chimera --version

在 CLI 内使用 /help 获取交互式帮助。

本地开发构建请参见构建与打包。

图谱运行时

Chimera 包含项目图谱索引、符号搜索、影响面发现和传播审计工作流。

常用命令：

chimera graph status
chimera graph init <project>
chimera graph query <symbol> --path <project>
chimera --graph status

项目本地图谱数据存放于 .chimera/ 目录。旧版 .codegraph/ 数据仅用于兼容；请通过 Chimera 图谱迁移命令显式迁移，不要手动移动或删除。

只读图谱入口（如 status 和 query）应报告当前 data-root 状态而不创建图谱数据。

开发

本仓库使用 Bun。从 chimera/ 工作区根目录安装依赖：

bun install

从包目录运行 Agent：

cd packages/chimera
bun run --conditions=browser src/index.ts

从包目录运行 typecheck 和测试，不要从仓库根目录运行：

cd packages/chimera
bun typecheck
bun test --timeout 30000

根目录的 test 脚本会有意阻止从根目录运行测试。

构建与打包

从 packages/chimera 构建默认的当前平台 no-WebUI 包：

OPENCODE_CHANNEL=latest bun run build --single --skip-install

默认包有意不嵌入 GPL 许可的 NewWeb/OpenCodeUI 衍生资源。如需为 release asset 额外生成明确分离的 with-WebUI 变体，再运行第二次构建：

OPENCODE_CHANNEL=latest bun run build --single --skip-install --with-webui --preserve-npm-tarballs

tarball 写入：

dist/npm-tarballs/

no-WebUI tarball 名称形如 coding-chimera-chimera-no-webui-<version>.tgz；with-WebUI tarball 在相同位置使用 with-webui 命名。variant 不进入 npm package name。

独立 no-WebUI CLI archive 继续使用 chimera-darwin-arm64.zip 等兼容名称；with-WebUI archive 增加 -with-webui。每个独立 archive 的根目录都包含该变体对应的许可文件。

可以用临时 npm prefix 对本地打包结果做 smoke test；每次只安装同一变体的主包与平台包：

prefix="$(mktemp -d)"
npm install -g --prefix "$prefix" dist/npm-tarballs/coding-chimera-chimera-darwin-arm64-no-webui-*.tgz dist/npm-tarballs/coding-chimera-chimera-no-webui-*.tgz
"$prefix/bin/chimera" --version
"$prefix/bin/chimera" --graph --help

仓库结构

  • packages/chimera — 完整 Chimera Agent 包与 CLI 运行时
  • packages/app — Web 应用
  • packages/console/app — Console UI 资源与应用
  • packages/desktop — 桌面应用
  • packages/sdk/js — JavaScript SDK 包
  • packages/docs — 文档包

贡献

提交变更前请阅读 CONTRIBUTING.md。

当变更涉及面向 Agent 的工具、prompt、图谱命令、安装器行为或包身份时，请在同一变更中同步更新对应的用户文档和 Agent 指引。

许可证

no-WebUI 主包和平台包使用 MIT 许可，包含仓库根 MIT LICENSE，且不包含 NewWeb payload。

with-WebUI 主包和平台包整体标记为 GPL-3.0-only：LICENSE 为 GPLv3，LICENSE-MIT 保留 Chimera runtime 的 MIT 许可，NOTICE 清晰说明组件、源码位置和边界。该变体嵌入 packages/newweb 中 GPL 许可的 NewWeb/OpenCodeUI 衍生 payload。

MIT