ContextSlim

Ahorra más del 50% de tokens de contexto de IA sin perder semántica crítica del código.

Código: github.com/lilite572-cyber/context-slim · instalación: @idmxgne/context-slim (cuenta npm idmxgne). No es el context-slim de Jagganu (recortador de salida CLI).

Cursor, Claude y otros agentes de codificación releen archivos completos en cada turno. La mayor parte de ese presupuesto son JSDoc, importaciones sin usar y mapeadores DTO. ContextSlim analiza JS/TS (Babel) y PHP (php-parser), vacía el ruido y conserva try/catch, métodos de autenticación, env() / process.env, y marcadores como FIXME / SECURITY / В ПРОД НЕ ГНАТЬ.

Antes / después

Medido en el controlador de facturación del mundo real en tests/fixtures/real_world_controller.ts (--signatures-only):

Las estadísticas CLI usan gpt-tokenizer (o200k_base, familia GPT-4o / GPT-5) y se imprimen en stderr. El código reducido va a stdout.

npx -y --package=@idmxgne/context-slim context-slim .
# Исходный размер: 3,522 токенов -> Сжатый: 1,408 токенов. Экономия: 60% ...

El binario es context-slim, no @idmxgne/context-slim. npx @idmxgne/context-slim . con ámbito falla con command not found.

Related MCP server: cctx-mcp

Inicio rápido

npx -y --package=@idmxgne/context-slim context-slim .
npx -y --package=@idmxgne/context-slim context-slim ./src --signatures-only
npx -y --package=@idmxgne/context-slim context-slim ./src --out slim.txt
npx -y --package=@idmxgne/context-slim context-slim-mcp

Desde un clon:

npm i && npm run build
node dist/cli.js ./src

Servidor MCP (Cursor, Windsurf, Claude Code)

Binario: context-slim-mcp → dist/mcp.js. Server + StdioServerTransport oficiales de @modelcontextprotocol/sdk. No escribas registros en stdout.

Prompt use-slim-context:

Prioriza siempre el uso de la herramienta read_slim_file al leer archivos de código fuente para optimizar la ventana de contexto.

Herramientas:

Cursor

Fusiona en ~/.cursor/mcp.json (copia lista: examples/cursor-mcp.json):

{
  "mcpServers": {
    "context-slim": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/context-slim/dist/mcp.js"]
    }
  }
}

Después de npm publish:

{
  "mcpServers": {
    "context-slim": {
      "command": "npx",
      "args": ["-y", "--package=@idmxgne/context-slim", "context-slim-mcp"]
    }
  }
}

Reinicia Cursor y pide al agente que use read_slim_file en un controlador pesado.

Windsurf

Mismo bloque mcpServers en la configuración MCP de Windsurf (~/.codeium/windsurf/mcp_config.json, o el panel MCP en ajustes). Apunta command a node + dist/mcp.js, o a npx como arriba.

Claude Code / Claude Desktop

Claude Desktop — fusiona examples/claude_desktop_config.json en claude_desktop_config.json:

{
  "mcpServers": {
    "context-slim": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/context-slim/dist/mcp.js"]
    }
  }
}

Claude Code:

claude mcp add context-slim -- node /ABSOLUTE/PATH/TO/context-slim/dist/mcp.js

Etiquetas seguras (.contextslimrc + isCriticalNode)

Un nodo nunca se vacía cuando isCriticalNode lo indica:

• comentarios que coinciden con CRITICAL, FIXME, TODO, SECURITY, DONT TOUCH, В ПРОД НЕ ГНАТЬ, @keep

• try / catch

• métodos cuyos nombres parecen autenticación (authorize, login, jwt, csrf, …)

• env(), getenv(), process.env

• PHP/Laravel: $this->hasMany / $this->belongsTo (y otras relaciones Eloquent) y métodos scope*

Repositorio: https://github.com/lilite572-cyber/context-slim

Añade frases adicionales en .contextslimrc en la raíz del proyecto:

{
  "keep_patterns": ["HACK", "LEGACY"]
}

entry_patterns (por defecto: index / cli / main / app / server) conservan cuerpos de funciones ordinarias incluso sin --signatures-only. Los archivos de dependencias se vacían; pasa --signatures-only (o MCP signaturesOnly: true) para vaciar todo lo que no sea crítico.

Instalación / publicación

npm i
npm test
npm run build

Binarios: context-slim → ./dist/cli.js, context-slim-mcp → ./dist/mcp.js. npm: @idmxgne/context-slim. GitHub: lilite572-cyber/context-slim. Licencia: MIT.

Licencia

MIT