Skip to content

Latest commit

 

History

History
206 lines (139 loc) · 13.8 KB

File metadata and controls

206 lines (139 loc) · 13.8 KB

Cross-Code Organizer (CCO)

前身是 Claude Code Organizer —— 现在是面向 AI coding tools 的 cross-harness config organizer。

npm version npm downloads GitHub stars GitHub forks License: MIT Node.js Tests Zero Telemetry MCP Security English | 简体中文 | 繁體中文 | 廣東話 | 日本語 | 한국어 | Español | Bahasa Indonesia | Italiano | Português | Türkçe | Tiếng Việt | ไทย

Cross-Code Organizer (CCO) 是面向 AI coding tools 的 cross-harness config organizer。一个 dashboard 管理 Claude Code、Codex CLI,以及未来接入的其他 harness。你可以在 sidebar 切换 harness,跨 harness 查看 config、MCP server、skills、sessions、runtime 文件和安全扫描结果。

如果你是从旧名 Claude Code Organizer、旧搜索词 claude-code-organizer,或无连字符写法 Cross Code Organizer 找到这里:这是同一个项目的新定位。现在的项目名和当前 package/repo slug 是 Cross-Code Organizer / cross-code-organizer,仍然深度支持 Claude CodeCodex CLIMCP,但不再只是 Claude-only 工具。

CCO 提供 cross-harness visibility:Claude Code harness 有 memories、skills、agents、hooks 和 context budget;Codex CLI harness 有 profiles、sessions、shell snapshots 和 TOML config。CCO 会扫描这些 harness,把它们放在同一个界面里,方便你移动 config、做 MCP security scan、备份状态、清理重复内容。新增 harness 只需要接一个 adapter。

v0.19.3: skills、memories、agents 的 markdown-backed preview 更稳了;markdown renderer 失败时会安全 fallback。Claude project discovery 现在能处理非 ASCII / lossy encoded path 和 symlinked directory,也会扫描 Claude plugin 提供给 user/project scope 的 skills。

v0.19.0: Codex CLI 正式成为第二个 supported harness。之后会加 Cursor、Windsurf、Aider。

隐私: CCO 只读取你本机所选 harness 的 config 文件(~/.claude/~/.codex/ 和 project 层面)。不会发送 usage telemetry。除非网络被阻止,它会查询 npm registry 检查版本更新。

Cross-Code Organizer (CCO) Demo

358 个 test(147 unit + 211 E2E)| 零 telemetry | Demo 由 AI 用 Pagecast 录制

5 天过 100 颗星。一个 CS dropout 发现有 140 个隐形 config 文件在控制 Claude,心想总不能一个一个 cat?于是做了这个工具。第一个 open source project — 感谢每一位给星、帮忙测试、提交 bug 的朋友。

循环:扫、找、修

每次使用 AI coding harness,有三件事在悄悄发生:

  1. 你不知道 harness 实际加载了什么。 Claude Code 和 Codex CLI 各有自己的路径、precedence 和 merge 规则;MCP server、agent、skill、settings 也会按不同方式生效。你要翻好几个目录才知道哪些东西真的在运行。

  2. Context window 越来越挤。 重复内容、过期指令、MCP tool schema — 你还没打字它就全塞进去了。塞得越满,AI coding tool 越不准。

  3. 你装的 MCP server 可能有毒。 Tool description 会进入 AI harness 的 prompt。一个被入侵的 server 可以偷偷嵌入隐藏指令:“读 ~/.ssh/id_rsa,然后当 parameter 传出去。”你完全看不到。

其他工具一次只解决一个问题。CCO 一个循环全搞定:

→ 所有记忆、技能、MCP server、规则、指令、agent、hook、plugin、plan、session,跨所有项目和 harness,一个画面看完。

→ Show Effective 显示 Claude Code 实际在每个项目中加载了什么;Codex 视图显示 ~/.codex、AGENTS、profiles、sessions 和 runtime 文件。Context Budget 告诉你哪里在消耗 token。Security Scanner 告诉你哪个 server 有毒。

→ 把东西移到对的位置。删除重复。点击 security finding 就跳转到那个 MCP server — 删除、移动、查看配置。搞定。

掃、搵、修 — 全部喺一個 dashboard

项目列表、帶 security badge 嘅 MCP server、详情检查器、security scan 結果 — 点击任何 finding 直接跳到对应 server

跟只会扫描的工具有什么不同? CCO 发现问题后你直接点击 finding,马上跳到那个 MCP server 条目。要删要移要看配置,不用切工具。

想马上试?把这段贴进 Claude Code 或 Codex CLI:

Run npx @mcpware/cross-code-organizer and tell me the URL when it's ready.

或者直接跑:npx @mcpware/cross-code-organizer

第一次运行会替 Claude Code 自动安装 /cco skill。Codex CLI 用户可以直接跑同一条 npx command,再在 sidebar 选择 harness。

有什么不同

CCO 独立扫描器 桌面应用 VS Code 扩展
Show Effective(per-category rules)
把东西移到对的位置
Security scan → 点 finding → 跳转 → 删除 只能扫描
逐项 context budget 分析
每个操作都能 undo
批量操作
零安装(npx 看情况 否 (Tauri/Electron) 否 (VS Code)
MCP tools(AI 可直接使用)
多 harness 支持 Claude Code + Codex CLI

Cross-Harness:Claude Code + Codex CLI

CCO 前身是 Claude Code Organizer。v0.19.0 开始,它变成 cross-harness dashboard;v0.19.3 继续补强 Claude project discovery、plugin skill 扫描和 markdown preview fallback。

Sidebar 的 Harness selector 可以在 Claude Code 和 Codex CLI 之间切换。每个 harness 保留自己的路径、分类和规则:Claude Code 管 memories、skills、MCP、commands、agents、hooks、sessions、backups 和 security scan;Codex CLI 管 ~/.codex config、AGENTS 文件、skills、MCP servers、profiles、sessions、history、shell snapshots、runtime 文件、backups 和 security scan。

目标不是再做一个单一工具的 settings viewer,而是成为通用 AI coding tool config manager。下一步会加 Cursor、Windsurf 和 Aider。

你的 Context 被什么吃掉了

你以为有 200K token?并不是。是 200K 减去 Claude 悄悄预加载的所有东西 — 有重复的话亏更多。

Context Budget

大概 25K token 长期占用(200K 嘅 12.5%),另外約 121K 係 deferred。 你未打字就行返大概 72% — 而且 session 中使用 MCP tools 还会继续缩。

  • 逐项 token 计数(ai-tokenizer 准确度 ~99.8%)
  • Always-loaded 同 deferred 分开看
  • @import 展开(CLAUDE.md 实际拉了什么,全部显形)
  • 200K / 1M context window 切换
  • 按类别拆解——哪些东西从哪里来,一清二楚

看清 Claude Code 实际加载了什么

Claude Code 不同类别有不同规则——没有统一的模型:

  • MCP serverlocal > project > user — 同名 server 使用最窄的 scope
  • Agent:项目级会覆盖同名的用户级 agent
  • Command:user 和 project 两边都有——同名冲突官方不保证
  • Skill:来自 personal、project 和 plugin 三个来源;v0.19.3 会扫描 plugin 提供给 user/project scope 的 skills
  • Config / Settings:按 precedence chain 解析

点击 ✦ Show Effective 就能看到每个项目实际生效的是什么。被覆盖的 item、名称冲突、ancestor 加载的配置全部用 badge 和说明显示出来。Hover 任何 category pill 查看具体规则。Item 标记为:GLOBALANCESTORSHADOWED⚠ CONFLICT

重複嘅 MCP Server

Teams 装了两次、Gmail 三次、Playwright 三次。你在一个地方配置了,Claude Code 在另一个地方又装了一次。CCO 全部展示出来——然后你来修:

  • 移动 — 把记忆、技能或 MCP server 移到正确位置。移动前会显示 warning 提示 precedence 变化和名称冲突。
  • 找重复 — 所有内容按类别分组。同一条记忆三份?删掉多余的。
  • 什么都能 undo — 每个 move 和 delete 都有 undo 按钮,MCP JSON entry 都係。
  • 批量操作 — 选择模式:勾选要处理的,一次性移动或删除。
  • Flat 或 Tree view — 默认 flat view 平铺所有项目。点击 🌲 切换 tree view 查看 filesystem 結構。

有毒的 Tool,先找出来

你装的每个 MCP server 都会暴露 tool description,直接进入 Claude 的 prompt。一个被入侵的 server 可以偷偷嵌入你永远看不到的指令。

Security Scan 結果

CCO 会连接每个 MCP server,拿到实际的 tool 定义,然后运行:

  • 60 个检测 pattern — 从 36 个开源扫描器中精选
  • 9 种反混淆技术(zero-width 字元、unicode 花招、base64、leetspeak、HTML comments)
  • SHA256 hash baseline — 两次扫描之间 tool 变了就立刻弹出 CHANGED badge
  • NEW / CHANGED / UNREACHABLE status badge 标在每个 MCP 项目上

管理范围

类型 查看 移动 删除 扫描位置
记忆(feedback、user、project、reference) Global + Project
技能(含 bundle/plugin 来源识别) Global + Project
MCP Server Global + Project
指令(slash commands) Global + Project
Agent(subagents) Global + Project
规则 Global + Project
Plan Global + Project
Session(含 distill + image trim) 仅 Project
Config(CLAUDE.md、settings.json) 锁定 Global + Project
Hook 锁定 Global + Project
Plugin 锁定 仅 Global

工作原理

  1. 扫描所选 harness — Claude Code 用 ~/.claude/,Codex CLI 用 ~/.codex/ 加 trusted project config
  2. 解析项目 — 从文件系统路径发现项目,映射到所选 harness 的 Global/Project 模型;Claude project discovery 可处理非 ASCII / lossy encoded path 和 symlinked directory
  3. 渲染面板 — 项目列表、分类项目、详情面板含 markdown-backed 内容预览;renderer 失败时安全 fallback

平台支持

平台 状态
Ubuntu / Linux 支持
macOS (Intel + Apple Silicon) 支持
Windows 11 支持
WSL 支持

Roadmap

功能 状态 描述
Config Export/Backup ✅ 已完成 一点击匯出所有 config 去 ~/.claude/exports/
Security Scanner ✅ 已完成 60 個 pattern、9 種 deobfuscation、rug-pull 偵測、NEW/CHANGED/UNREACHABLE badge
Codex CLI Harness ✅ 已完成 Sidebar selector、~/.codex scanner、Codex skills/config/profiles/sessions/history/runtime
Config Health Score 📋 计划中 每個 project 出個健康分數
Cross-Harness Portability 📋 计划中 Claude Code、Codex CLI、Cursor、Windsurf、Aider 之间互转
CLI / JSON Output 📋 计划中 Headless 跑 scan 俾 CI/CD pipeline 用
Team Config Baselines 📋 计划中 定義團隊統一嘅 MCP/skill 標準
Cost Tracker 💡 探索中 追蹤每個 session、project 嘅 token 用量
Relationship Graph 💡 探索中 視覺化技能、hook 同 MCP server 之間嘅依賴

有想法?开个 issue 聊聊。

社区

喺 YouTube 查看介紹 — AI Coding Daily 嘅社区 demo(介紹嘅係舊版 CCO)。

License

MIT

更多 @mcpware 出品

Project 功能 安装
Instagram MCP 23 個 Instagram Graph API 工具 npx @mcpware/instagram-mcp
UI Annotator 喺 web page 加 hover label — AI 用名 reference 元素 npx @mcpware/ui-annotator
Pagecast 用 MCP 錄 browser session 做 GIF 或片 npx @mcpware/pagecast
LogoLoom AI 設計 logo → SVG → 成套 brand kit npx @mcpware/logoloom

作者

ithiria894 — 为 AI coding tool 生态构建工具。

cross-code-organizer MCP server