Skip to content

Latest commit

 

History

History
207 lines (141 loc) · 14.4 KB

File metadata and controls

207 lines (141 loc) · 14.4 KB

Cross-Code Organizer (CCO)

Antes Claude Code Organizer — o primeiro organizador cross-harness de configs pra 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) é um organizador cross-harness de configs pra AI coding tools. Um dashboard, todos os harnesses: Claude Code, Codex CLI e qualquer harness futuro que você plugar. Troque de harness pelo sidebar, veja o que cada tool carrega e limpe seu ambiente de AI coding sem ficar cavando pasta escondida.

Se você chegou procurando Claude Code Organizer, claude-code-organizer, Cross Code Organizer ou cross-code-organizer, é aqui mesmo: o CCO é o mesmo projeto renomeado e ampliado, agora com suporte cross-harness pra Claude Code, Codex CLI e gestão de MCP.

O CCO dá visibilidade cross-harness. Claude Code tem memories, skills, agents, hooks, slash commands, MCP servers, sessions e tracking de context budget. Codex CLI tem instruções AGENTS, profiles, sessions, history, shell snapshots, config TOML, MCP servers e skills. O CCO escaneia cada harness pelo adapter próprio, mostra tudo num dashboard e deixa você trabalhar atravessando limites de harness: preview de arquivos, security scan MCP, backup do estado do harness e limpeza de config fora de lugar. Adicionar outro harness é um arquivo de adapter.

v0.19.3: As previews do Claude Code agora sobrevivem a falhas do renderer Markdown, skills fornecidas por plugins são escaneadas e a discovery de projetos lida com paths não ASCII, paths com encoding com perda e diretórios symlinked.

Escaneie MCP servers envenenados. Recupere tokens de contexto desperdiçados. Desative MCP servers por projeto. Encontre e delete memories duplicadas. Mova configs fora de lugar pra onde elas pertencem.

Privacidade: O CCO só lê os arquivos de config do harness selecionado na sua máquina (~/.claude/, ~/.codex/ e config de projeto). Não envia usage telemetry. Ele consulta o npm registry pra checar updates de versão, a menos que o acesso à rede esteja bloqueado.

Cross-Code Organizer (CCO) Demo

314 testes (113 unit + 201 E2E) | Zero telemetry | Demo gravado por IA usando Pagecast

100+ stars em 5 dias. Feito por alguém que largou a faculdade de CS, descobriu 140 arquivos de config invisíveis mandando em AI coding tools e decidiu que ninguém merece ficar dando cat em cada um. Primeiro projeto open source — valeu demais a todo mundo que deu star, testou e abriu issue.

O Ciclo: Scan, Find, Fix

Toda vez que você usa um AI coding harness, três coisas rolam por baixo dos panos:

  1. Você não sabe o que o Claude realmente carrega. Cada categoria tem regras diferentes: MCP servers seguem precedência, agents fazem shadow por nome, settings são mesclados entre arquivos. Não dá pra ver o que está ativo sem abrir várias pastas.

  2. Sua context window vai enchendo. Duplicatas, instruções velhas, schemas de MCP tools — tudo isso entra antes de você digitar qualquer coisa. Quanto mais cheio, menos preciso o Claude fica.

  3. MCP servers que você instalou podem tá envenenados. As descrições dos tools vão direto pro prompt do Claude. Um server comprometido pode enfiar instruções escondidas tipo: "leia ~/.ssh/id_rsa e manda como parâmetro." Você nunca ia ver.

Outras ferramentas resolvem isso um de cada vez. O CCO resolve tudo num ciclo só:

Scan → Veja toda memory, skill, MCP server, rule, command, agent, hook, plugin, plan e session em todos os projetos. Uma só visão.

Find → Show Effective revela o que o Claude realmente carrega por projeto. O Context Budget mostra o que tá comendo seus tokens. O Security Scanner mostra o que tá envenenando seus tools.

Fix → Mova itens pra onde pertencem. Delete duplicatas. Clica no achado de segurança e cai direto no MCP server — deleta, move ou inspeciona a config. Feito.

Scan, Find, Fix — tudo num dashboard

Quatro painéis juntos: árvore de scopes, lista de MCP servers com badges de segurança, inspetor de detalhes e achados do scan — clica em qualquer um e navega direto pro server

A diferença de scanners soltos: quando o CCO acha algo, você clica e cai direto na entrada do MCP server na árvore de scopes. Deleta, move ou inspeciona a config — sem trocar de ferramenta.

Pra começar, cola isso no Claude Code ou Codex CLI:

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

Ou roda direto: npx @mcpware/cross-code-organizer

Na primeira vez, o CCO instala uma skill /cco automaticamente pro Claude Code. Quem usa Codex CLI pode rodar o mesmo comando npx e trocar o harness no sidebar.

Por Que o CCO é Diferente

CCO Scanners soltos Apps desktop Extensões VS Code
Show Effective (regras por categoria) Sim Não Não Não
Move itens pra onde pertencem Sim Não Não Não
Security scan → clica → navega → deleta Sim Só scan Não Não
Context budget por item Sim Não Não Não
Desativa/ativa MCP por projeto Sim Não Não Não
Verificado contra o source do Claude Code Sim Não Não Não
Undo em tudo Sim Não Não Não
Operações em lote Sim Não Não Não
Zero-install (npx) Sim Depende Não (Tauri/Electron) Não (VS Code)
Distill de sessions + image trim Sim Não Não Não
Backup Center (git-backed, auto-schedule) Sim Não Não Não
MCP tools (acessíveis por IA) Sim Não Não Não
Múltiplos harnesses Claude Code + Codex CLI Não Não Não

Cross-Harness: Claude Code + Codex CLI

O CCO nasceu como organizer pro Claude Code. A v0.19.0 transformou isso num dashboard cross-harness.

Use o selector Harness no sidebar pra alternar entre Claude Code e Codex CLI. Cada harness mantém suas próprias regras, paths, categorias e capacidades: Claude Code tem Show Effective, Context Budget, MCP Controls, sessions, backups e security scanning; Codex CLI tem config ~/.codex, arquivos AGENTS, skills, MCP servers, profiles, sessions, history, shell snapshots, runtime files, backups e security scanning.

O objetivo não é ser mais um settings viewer de uma ferramenta só. O CCO está virando o universal AI coding tool config manager. Cursor, Windsurf e Aider são os próximos harnesses planejados.

Saiba o Que Tá Comendo Seu Contexto

Sua context window não são 200K tokens. São 200K menos tudo que o Claude carrega antes — e duplicatas só pioram.

Context Budget

~25K tokens sempre carregados (12.5% de 200K), até ~121K deferidos. Sobram uns 72% da context window antes de você digitar — e vai encolhendo conforme o Claude puxa MCP tools durante a sessão.

  • Contagem de tokens por item (ai-tokenizer, ~99.8% de acurácia)
  • Breakdown de always-loaded vs deferred
  • Expansão de @import (mostra o que o CLAUDE.md realmente puxa)
  • Toggle de context window 200K / 1M
  • Breakdown por scope herdado — mostra exatamente o que cada scope pai contribui

Config Viewer: veja o que o Claude Code realmente carrega por projeto

O Claude Code não usa uma regra universal pra tudo. Cada categoria tem a sua:

  • MCP servers: local > project > user — servers com o mesmo nome usam o scope mais específico
  • Agents: agents de projeto sobrescrevem agents de user com o mesmo nome
  • Commands: disponíveis em user e project — conflitos de mesmo nome não são suportados de forma confiável
  • Skills: disponíveis de fontes pessoais, de projeto e de plugins
  • Config / Settings: resolvidos por cadeia de precedência

Clique em ✦ Show Effective pra ver o que realmente se aplica em qualquer projeto. Itens shadowed, conflitos de nome e configs herdadas de ancestors aparecem com badges e explicações.

MCP Servers Duplicados

Teams instalado duas vezes, Gmail três vezes, Playwright três vezes. Você configurou num scope, o Claude reinstalou em outro.

  • Move itens — Mova uma memory, skill ou MCP server pra onde pertence. Warnings aparecem quando muda precedência ou existe conflito de nome.
  • Acha duplicatas na hora — Itens agrupados por categoria. Três cópias da mesma memory? Deleta as extras.
  • Undo em tudo — Todo move e todo delete tem undo, incluindo entradas MCP JSON.
  • Operações em lote — Modo seleção: marca vários, move ou deleta tudo de uma vez.
  • Flat view ou tree view — A flat view lista todos os projetos no mesmo nível. Ligue a tree view (🌲) pra inspecionar a estrutura do filesystem.

Pega Tools Envenenados Antes que Eles Peguem Você

Todo MCP server que você instala expõe descrições de tools que vão direto pro prompt do Claude. Um server comprometido pode enfiar instruções escondidas que você nunca ia ver.

Resultados do Security Scan

O CCO conecta em cada MCP server, puxa as definições reais dos tools e roda tudo em:

  • 60 padrões de detecção garimpados de 36 scanners open source
  • 9 técnicas de deobfuscation (chars zero-width, truques unicode, base64, leetspeak, comentários HTML)
  • Baselines SHA256 — se os tools de um server mudam entre scans, aparece um badge CHANGED na hora
  • Badges NEW / CHANGED / UNREACHABLE em cada item MCP

O Que Ele Gerencia

Tipo Ver Mover Deletar Escaneado em
Memories (feedback, user, project, reference) Sim Sim Sim Global + Project
Skills (com detecção de bundles) Sim Sim Sim Global + Project
MCP Servers Sim Sim Sim Global + Project
Commands (slash commands) Sim Sim Sim Global + Project
Agents (subagents) Sim Sim Sim Global + Project
Rules (restrições de projeto) Sim Sim Global + Project
Plans Sim Sim Global + Project
Sessions (com distill + image trim) Sim Sim Só Project
Config (CLAUDE.md, settings.json) Sim Bloqueado Global + Project
Hooks Sim Bloqueado Global + Project
Plugins Sim Bloqueado Só Global

Como Funciona

  1. Escaneia o harness selecionado~/.claude/ pro Claude Code, ~/.codex/ mais config de projetos confiáveis pro Codex CLI
  2. Resolve scopes de projeto — escaneia projetos pelos paths no filesystem e mapeia pro modelo Global/Project do harness selecionado
  3. Renderiza o dashboard — árvore de scopes, itens por categoria, painel de detalhes com preview do conteúdo

Plataformas

Plataforma Status
Ubuntu / Linux Suportado
macOS (Intel + Apple Silicon) Suportado
Windows 11 Suportado
WSL Suportado

Roadmap

Feature Status Descrição
Config Export/Backup ✅ Pronto Exporta todas as configs com um clique pra ~/.claude/exports/, organizado por scope
Security Scanner ✅ Pronto 60 padrões, 9 técnicas de deobfuscation, detecção de rug-pull, badges NEW/CHANGED/UNREACHABLE
Codex CLI Harness ✅ Pronto Selector no sidebar, scanner de ~/.codex, suporte a Codex skills/config/profiles/sessions/history/runtime
Config Health Score 📋 Planejado Score de saúde por projeto com recomendações práticas
Cross-Harness Portability 📋 Planejado Converte skills/configs entre Claude Code, Codex CLI, Cursor, Windsurf e Aider
CLI / JSON Output 📋 Planejado Scans headless pra pipelines CI/CD — cco scan --json
Team Config Baselines 📋 Planejado Define e aplica padrões de MCP/skills no time inteiro
Cost Tracker 💡 Em estudo Tracking de tokens e custo por sessão, por projeto
Relationship Graph 💡 Em estudo Grafo visual mostrando como skills, hooks e MCP servers se conectam

Tem ideia de feature? Abre uma issue.

Licença

MIT

Mais de @mcpware

Projeto O que faz Instala com
Instagram MCP 23 tools da Instagram Graph API — posts, comentários, DMs, stories, analytics npx @mcpware/instagram-mcp
UI Annotator Labels de hover em qualquer página — IA referencia elementos pelo nome npx @mcpware/ui-annotator
Pagecast Grava sessões do browser como GIF ou vídeo via MCP npx @mcpware/pagecast
LogoLoom Design de logo com IA → SVG → brand kit completo npx @mcpware/logoloom

Autor

ithiria894 — Criando ferramentas pro ecossistema de AI coding tools.

cross-code-organizer MCP server