{
  "markdown": "# Memory Context Optimizer\n\nUniversal memory and context optimizer for AI coding agents. Load minimal context, rank relevance, compact at 60%, detect stale memory, and redact secrets.\n\n## What It Does\n\nOptimizes active context usage by:\n- **Minimal loading**: Load only what's essential for the current task\n- **Smart ranking**: Prioritize files, memory, and context by relevance\n- **Auto recall**: Compact context automatically when usage hits 60%\n- **Compression**: Reduce verbose logs while preserving exact errors/identifiers\n- **Redaction**: Keep secrets safe, never dump sensitive data\n- **Audit**: Detect stale, conflicting, or outdated memory entries\n\n## Before / After\n\n**Without MCO** (context bloat):\n```\nContext: 85,000 tokens\n- Full repo dump\n- All memory entries\n- Stack traces repeated 3x\n- Redundant system prompts\n```\n\n**With MCO** (optimized):\n```\nContext: 28,000 tokens\n- Current task + criteria\n- Ranked file list (top 20)\n- Recall summary (compact)\n- Active errors only\n- Critical facts only\n```\n\n## Quick Install\n\n```bash\n# Unix/macOS\ncurl -fsSL https://raw.githubusercontent.com/bantoilatoi/memory-context-optimizer/master/install.sh | bash\n\n# Windows (PowerShell)\nirm https://raw.githubusercontent.com/bantoilatoi/memory-context-optimizer/master/install.ps1 | iex\n```\n\nOr directly with Node.js:\n```bash\nnode bin/install.js --all\n```\n\n## Runtime\n\n**Node.js v20+ required.** No pip, no npm dependencies, no Docker, no daemon.\n\n## Daily Use\n\nWhen working in a project with MCO installed:\n\n```\nAnalyze my codebase for memory optimization opportunities. Focus on \nstale entries and context bloat patterns.\n```\n\nOr manually trigger:\n```bash\nnode bin/memory-context.js recall    # Compact at 60%\nnode bin/memory-context.js rank     # Rank by relevance\nnode bin/memory-context.js audit    # Check for stale/conflicts\nnode bin/memory-context.js compress # Compress logs\n```\n\n## Memory Path\n\nDefault: `.memory-context/`\n\nCompatible paths:\n- `.qwen/memory/`\n- `.claude/memory/`\n- `.gemini/memory/`\n- `.opencode/memory/`\n- `.codex/memory/`\n\n> **Note**: `deprecated memory path` is deprecated and not used.\n\n## Auto Recall at 60%\n\nWhen active context reaches 60% usage:\n1. Stop broad loading\n2. Build compact recall summary\n3. Preserve current task + criteria\n4. Keep exact identifiers (file paths, function names, errors)\n5. Compress volatile logs\n6. Mark stale/conflicting entries\n7. Continue from summary\n\n## Supported Agents\n\n| Agent | Support Level |\n|-------|---------------|\n| Claude Code | Full (.claude-plugin) |\n| Gemini CLI | Full (gemini-extension.json) |\n| Qwen Code | Full (qwen-extension.json) |\n| Codex CLI | Full (AGENTS.md) |\n| OpenCode | Full (AGENTS.md) |\n| Cursor | Partial (rule files) |\n| Windsurf | Partial (rule files) |\n| Cline | Partial (rule files) |\n| Copilot | Partial (rule files) |\n\n## Validate Installation\n\n```bash\nnode src/tools/validate-repository.js\nnode bin/install.js --list\nnode bin/install.js --dry-run --all\n```\n\n## Extension Install Tests\n\n```bash\nnode bin/install.js --test-install --only generic\nnode bin/install.js --test-install --only gemini\nnode bin/install.js --test-install --only qwen\nnode bin/install.js --test-install --only claude\n```\n\nReal Gemini CLI install:\n```bash\ngemini extensions install .\ngemini extensions list\n```\n\n## Safety & Privacy\n\n- No telemetry\n- No external services (except optional Gemini CLI extension)\n- Secrets redacted before context inclusion\n- No background processes or daemons\n\n## Project Structure\n\n```\nmemory-context-optimizer/\n  skills/          # Single source of truth for behavior\n  agents/          # Subagent role definitions\n  commands/        # Command prompt stubs\n  plugins/         # Distribution mirrors\n  src/             # Internal implementation\n  context/         # YAML policies\n  prompts/         # Reusable prompt templates\n  adapters/        # Provider-specific views\n```\n\nSee [INSTALL.md](INSTALL.md) for detailed installation per agent.\n\nSee [CLAUDE.md](CLAUDE.md) for maintainer documentation.\n",
  "bytes": 4012,
  "sha": "720c5e3b8ef9d532015bb13800366d6ecf57ee8ee89d2c602483aeb9d5582448",
  "repo_slug": "bantoilatoi/memory-context-optimizer",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bantoilatoi_memory_context_optimizer_5d1dd542/readme"
}