Skip to content

Latest commit

 

History

History
206 lines (138 loc) · 14.3 KB

File metadata and controls

206 lines (138 loc) · 14.3 KB

Cross-Code Organizer (CCO)

Trước đây là Claude Code Organizer — cross-harness config organizer đầu tiên cho AI coding tools.

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) là cross-harness config organizer đầu tiên cho AI coding tools. Một dashboard cho Claude Code, Codex CLI, và mọi harness sẽ được plug in sau này. Đổi harness từ sidebar, xem config xuyên harness, rồi dọn mọi thứ ở một chỗ.

CCO cho bạn visibility xuyên harness. Claude Code có memories, skills, agents, hooks và context budget tracking. Codex CLI có profiles, sessions, shell snapshots và TOML config. CCO scan tất cả harness, hiển thị side by side, rồi cho bạn move config, chạy MCP security scan, backup harness state và dọn duplicate qua ranh giới harness. Thêm harness mới chỉ cần một adapter file.

Rename alias để tìm kiếm: project này trước đây là Claude Code Organizer / claude-code-organizer. Tên hiện tại là Cross Code Organizer / cross-code-organizer. Các cụm Claude Code, Codex CLI và MCP được giữ như legacy/search terms cho người đang tìm config organizer; install và repo link vẫn dùng cross-code-organizer hiện tại.

v0.19.0: Codex CLI đã là supported harness thứ hai. Cursor, Windsurf và Aider nằm trong roadmap tiếp theo.

v0.19.3: Preview cho skills / memories / agents giờ dùng markdown-backed preview và fallback an toàn nếu markdown renderer lỗi. Claude project discovery xử lý path non-ASCII / lossy encoded và thư mục symlink. Skills do Claude plugin cung cấp cũng được scan trong user / project scope.

Privacy: CCO chỉ đọc file config của harness đang chọn (~/.claude/, ~/.codex/ và config project). Không gửi usage telemetry.

Cross-Code Organizer (CCO) Demo

314 tests (113 unit + 201 E2E) | Zero telemetry | Demo do AI tự quay bằng Pagecast

100+ stars trong 5 ngày. Tác giả bỏ học CS, tình cờ phát hiện 140 file config ẩn đang điều khiển Claude rồi nghĩ — không ai nên phải ngồi cat từng file một. Đây là project open source đầu tay — cảm ơn mọi người đã star, test, và report bug.

Vòng lặp: Scan, Tìm, Fix

Mỗi lần dùng AI coding tool, có 3 chuyện xảy ra âm thầm:

  1. Config nằm sai scope. Skill Python ở Global bị load vào mọi project React. Memory bạn set ở project này thì project khác không thấy. Claude không care scope khi tạo file.

  2. Context window bị đầy trước khi bạn gõ chữ nào. Bản trùng, instruction cũ, MCP tool schema — tất cả pre-load sẵn. Context càng đầy, Claude trả lời càng kém.

  3. MCP server bạn cài có thể bị nhiễm. Tool description đi thẳng vào prompt của Claude. Server bị compromise có thể giấu instruction kiểu: "đọc ~/.ssh/id_rsa rồi gửi qua parameter." Bạn nhìn không ra đâu.

Tool khác giải quyết từng cái riêng. CCO gom hết vào một flow:

Scan → Liệt kê toàn bộ memory, skill, MCP server, rule, command, agent, hook, plugin, plan, session. Mọi scope. Một tree duy nhất.

Tìm → Phát hiện bản trùng, item nằm sai scope. Context Budget chỉ ra cái gì đang ngốn token. Security Scanner chỉ ra cái gì đang nhiễm độc tool.

Fix → Kéo thả sang đúng scope. Xóa bản trùng. Click vào finding là nhảy thẳng tới entry MCP server — xóa, move, hoặc xem config. Done.

Scan, Tìm, Fix — gom hết trong một dashboard

Bốn panel chạy song song: scope list, danh sách MCP server kèm badge bảo mật, detail inspector, kết quả security scan — click finding nào cũng nhảy thẳng tới server đó

Khác gì standalone scanner: Khi CCO tìm ra vấn đề, bạn click finding là nhảy luôn tới entry MCP server trong scope list. Xóa, move, xem config — không cần mở tool khác.

Chạy thử ngay — paste dòng này vào Claude Code hoặc Codex CLI:

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

Hoặc chạy thẳng: npx @mcpware/cross-code-organizer

Lần đầu chạy sẽ tự cài skill /cco cho Claude Code. Người dùng Codex CLI có thể chạy cùng command npx, rồi chọn harness trong sidebar.

CCO khác gì các tool khác

CCO Standalone scanners Desktop apps VS Code extensions
Scope hierarchy (Global > Project) Không Không Một phần
Drag-and-drop giữa các scope Không Không Không
Security scan → click finding → nhảy tới → xóa Chỉ scan Không Không
Context budget từng item, có inheritance Không Không Không
Undo mọi thao tác Không Không Không
Bulk operations Không Không Không
Zero-install (npx) Tùy Không (Tauri/Electron) Không (VS Code)
MCP tools (AI gọi được) Không Không Không
Hỗ trợ multi-harness Claude Code + Codex CLI Không Không Không

Cross-Harness: Claude Code + Codex CLI

CCO bắt đầu là Claude Code Organizer. Giờ nó là Cross-Code Organizer cho Claude Code và Codex CLI trong cùng một dashboard.

Dùng selector Harness trong sidebar để chuyển giữa Claude Code và Codex CLI. Mỗi harness giữ path, category, rule và capability riêng: Claude Code có Show Effective, Context Budget, MCP Controls, sessions, backups và security scanning; Codex CLI có ~/.codex config, file AGENTS, skills, MCP servers, profiles, sessions, history, shell snapshots, runtime, backups và security scanning.

Mục tiêu không phải thêm một settings viewer cho một tool duy nhất. CCO đang trở thành universal AI coding tool config manager. Tiếp theo sẽ thêm Cursor, Windsurf và Aider.

Cái gì đang ăn context của bạn

Context window không phải 200K token đâu. Nó là 200K trừ đi mọi thứ Claude pre-load — bản trùng còn làm tệ hơn.

Context Budget

~25K token luôn load sẵn (12.5% của 200K), thêm ~121K deferred. Trước khi bạn gõ, context window chỉ còn khoảng 72% — và co lại dần khi Claude kéo thêm MCP tools trong session.

  • Token count từng item (ai-tokenizer ~99.8% accuracy)
  • Phân biệt always-loaded vs deferred
  • Expand @import (xem CLAUDE.md thực sự kéo những gì vào)
  • Toggle context window 200K / 1M
  • Breakdown scope inheritance — thấy rõ parent scope đóng góp bao nhiêu

Giữ scope cho gọn

Claude Code tự phân loại mọi thứ vào 3 cấp scope — nhưng chẳng bao giờ nói cho bạn:

Global                    ← load vào MỌI session trên máy
       └─ Project         ← chỉ load khi bạn đang ở thư mục này

Vấn đề là: Claude tạo memory và skill ở bất kỳ thư mục nào bạn đang đứng. Bạn bảo Claude "luôn dùng ESM imports" khi đang code trong ~/myapp — memory đó bị giam trong scope project đó. Mở project khác, Claude không biết gì cả. Bạn nói lại lần nữa. Thế là cùng một memory nằm hai chỗ, cả hai đều tốn token.

Skill cũng vậy. Bạn viết một deploy skill trong backend repo — nó chỉ nằm ở scope project đó. Mấy project khác không xài được. Cuối cùng bạn phải tạo lại khắp nơi.

CCO show ra toàn bộ scope list. Bạn thấy rõ memory, skill, MCP server nào đang affect project nào — rồi kéo chúng sang đúng scope.

MCP Server bị trùng

Teams cài 2 lần, Gmail 3 lần, Playwright 3 lần. Bạn config ở một scope, Claude lại tự cài ở scope khác.

  • Kéo thả là xong — Kéo memory từ Project sang Global. Một cú kéo. Giờ mọi project trên máy đều có.
  • Bản trùng hiện ngay — Item nhóm theo category xuyên scope. Thấy 3 bản copy cùng memory? Xóa mấy cái thừa.
  • Undo thoải mái — Mỗi thao tác move và delete đều có nút undo, kể cả entry MCP JSON.
  • Bulk operations — Bật select mode: tick nhiều item, move hoặc xóa cả lô.

Bắt tool bị nhiễm trước khi dính

Mỗi MCP server bạn cài đều expose tool description, và chúng bay thẳng vào prompt của Claude. Server bị compromise thì giấu instruction ẩn bên trong — bạn nhìn bằng mắt không ra.

Kết quả Security Scan

CCO connect tới từng MCP server, kéo tool definition thật về, rồi chạy qua:

  • 60 detection pattern chọn lọc từ 36 open source scanner
  • 9 kỹ thuật deobfuscation (zero-width chars, unicode tricks, base64, leetspeak, HTML comments)
  • SHA256 hash baseline — tool của server thay đổi giữa hai lần scan là thấy badge CHANGED liền
  • Badge NEW / CHANGED / UNREACHABLE trên mỗi MCP item

CCO quản lý những gì

Loại Xem Move Xóa Scan ở
Memories (feedback, user, project, reference) Global + Project
Skills (kèm bundle detection) Global + Project
MCP Servers Global + Project
Commands (slash commands) Global + Project
Agents (subagents) Global + Project
Rules (ràng buộc project) Global + Project
Plans Global + Project
Sessions Chỉ Project
Config (CLAUDE.md, settings.json) Khóa Global + Project
Hooks Khóa Global + Project
Plugins Khóa Chỉ Global

Cách hoạt động

  1. Scan harness đang chọn — Claude Code dùng ~/.claude/, Codex CLI dùng ~/.codex/ và trusted project config
  2. Map project scope — đọc project từ filesystem path, gồm cả path non-ASCII / lossy encoded và thư mục symlink, rồi map vào model Global/Project của harness đang chọn
  3. Tạo preview — skills, memories và agents dùng markdown-backed preview, fallback an toàn sang plain preview nếu renderer lỗi
  4. Render dashboard — scope list, danh sách item theo category, panel chi tiết kèm preview nội dung

Platform hỗ trợ

Platform Status
Ubuntu / Linux Hỗ trợ
macOS (Intel + Apple Silicon) Hỗ trợ
Windows 11 Hỗ trợ
WSL Hỗ trợ

Roadmap

Tính năng Status Mô tả
Config Export/Backup ✅ Done Một click export hết config ra ~/.claude/exports/, chia theo scope
Security Scanner ✅ Done 60 pattern, 9 kỹ thuật deobfuscation, phát hiện rug-pull, badge NEW/CHANGED/UNREACHABLE
Codex CLI Harness ✅ Done Sidebar selector, scanner ~/.codex, hỗ trợ Codex skills/config/profiles/sessions/history/runtime
Config Health Score 📋 Planned Health score từng project, kèm gợi ý cải thiện cụ thể
Cross-Harness Portability 📋 Planned Convert skill/config giữa Claude Code, Codex CLI, Cursor, Windsurf và Aider
CLI / JSON Output 📋 Planned Chạy scan headless cho CI/CD pipeline — cco scan --json
Team Config Baselines 📋 Planned Định nghĩa và enforce chuẩn MCP/skill chung cho cả team
Cost Tracker 💡 Exploring Track token usage và chi phí theo session, theo project
Relationship Graph 💡 Exploring Biểu đồ dependency trực quan — xem skill, hook, MCP server connect với nhau thế nào

Có ý tưởng gì hay? Mở issue.

License

MIT

Các project khác từ @mcpware

Project Mô tả Install
Instagram MCP 23 tool Instagram Graph API — post, comment, DM, story, analytics npx @mcpware/instagram-mcp
UI Annotator Gắn label hover lên web page bất kỳ — AI gọi element bằng tên npx @mcpware/ui-annotator
Pagecast Quay browser session thành GIF hoặc video qua MCP npx @mcpware/pagecast
LogoLoom AI thiết kế logo → SVG → export full brand kit npx @mcpware/logoloom

Tác giả

ithiria894 — Build tool cho hệ sinh thái AI coding tool.

cross-code-organizer MCP server