Summary

Claude Code Organizer (CCO) addresses the complexity of managing Claude Code's numerous configuration files, offering a dashboard to streamline memories, skills, MCP servers, and settings. It targets users seeking to mitigate security risks like tool poisoning, optimize context token usage, and eliminate configuration duplication. CCO provides a centralized, efficient, and secure way to manage AI agent setups.

How It Works

CCO operates on a "Scan → Find → Fix" loop, providing a unified dashboard for all Claude Code configurations across global and project scopes. Its core approach involves scanning local files to reveal Claude Code's actual loaded state ("Show Effective"), tracking context token budgets per item, and identifying security vulnerabilities in MCP servers. The dashboard facilitates direct remediation, allowing users to move misplaced configurations, delete duplicates, and address security findings without switching tools. This integrated workflow is novel compared to standalone diagnostic tools.

Quick Start & Requirements

• Primary install/run command: npx @mcpware/claude-code-organizer. The first execution automatically installs a /cco skill for subsequent access.
• Prerequisites: Zero dependencies are explicitly listed, implying reliance on Node.js for npx.
• Links: No specific documentation or demo links are provided within the README text, beyond the execution command.

Highlighted Details

• Security Scanner: Employs 60 detection patterns and 9 deobfuscation techniques to identify MCP tool poisoning and prompt injection. Findings are directly actionable, linking to the problematic MCP server entry for inspection or removal.
• Context Budget Accuracy: Verified against leaked Claude Code source, CCO provides precise token counts for pre-loaded items, distinguishing between "always-loaded" and "deferred" tokens, crucial for optimizing context window usage.
• Session Distiller: Compresses session JSONL files by up to 90% (e.g., 70MB to 7MB) by stripping non-essential tool outputs while preserving the full conversation text.
• Integrated Remediation: A key differentiator is the seamless "scan-navigate-fix" workflow, where issues identified by the scanner or configuration analysis directly link to the relevant configuration item for immediate editing or deletion.

Maintenance & Community

Developed by ithiria894, the project saw rapid adoption with over 100 stars in its first five days. While specific community channels like Discord or Slack are not detailed, the project encourages feature ideas via issue tracking. The roadmap outlines planned enhancements.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license permits commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The project is actively developed, with several features listed as "Planned" on the roadmap, including headless CLI operation for CI/CD pipelines and cross-harness portability. Currently, CCO functions primarily as an interactive browser dashboard, lacking direct CI/CD integration.