ContextSlim

AIコンテキストトークンを50%以上節約。重要なコードの意味は失わずに。

コード: github.com/lilite572-cyber/context-slim · インストール: @idmxgne/context-slim (npmアカウント idmxgne)。Jagganuのcontext-slim（CLI出力トリマー）とは別物です。

Cursor、Claude、その他のコーディングエージェントは、ターンごとにファイル全体を読み直します。その予算の大半はJSDoc、未使用のインポート、DTOマッパーです。ContextSlimはJS/TS（Babel）とPHP（php-parser）を解析し、ノイズを空洞化しつつ、try/catch、認証メソッド、env() / process.env、FIXME / SECURITY / В ПРОД НЕ ГНАТЬ などのマーカーは保持します。

変更前 / 変更後

tests/fixtures/real_world_controller.ts の実世界の請求コントローラーで測定（--signatures-only）:

CLI統計はgpt-tokenizer（o200k_base、GPT-4o / GPT-5系）を使用し、stderrに出力します。スリム化されたソースはstdoutに出力されます。

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

バイナリは context-slim であり、@idmxgne/context-slim ではありません。スコープ付きの npx @idmxgne/context-slim . は command not found で失敗します。

Related MCP server: cctx-mcp

クイックスタート

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

クローンから:

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

MCPサーバー（Cursor、Windsurf、Claude Code）

バイナリ: context-slim-mcp → dist/mcp.js。公式の @modelcontextprotocol/sdk の Server + StdioServerTransport。stdoutにログを書き込まないでください。

プロンプト use-slim-context:

ソースコードファイルを読む際は、コンテキストウィンドウを最適化するために常に read_slim_file ツールの使用を優先してください。

ツール:

Cursor

~/.cursor/mcp.json にマージします（既製コピー: examples/cursor-mcp.json）:

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

npm publish 後:

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

Cursorを再起動し、エージェントに肥大化したコントローラーで read_slim_file を実行するよう依頼します。

Windsurf

WindsurfのMCP設定（~/.codeium/windsurf/mcp_config.json、または設定のMCPパネル）に同じ mcpServers ブロックを使用します。command を node + dist/mcp.js に向けるか、上記のように npx に向けます。

Claude Code / Claude Desktop

Claude Desktop — examples/claude_desktop_config.json を 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

安全ラベル（.contextslimrc + isCriticalNode）

isCriticalNode がそう判断した場合、ノードは決して空洞化されません:

• CRITICAL、FIXME、TODO、SECURITY、DONT TOUCH、В ПРОД НЕ ГНАТЬ、@keep に一致するコメント

• try / catch

• 認証らしい名前のメソッド（authorize、login、jwt、csrf など）

• env()、getenv()、process.env

• PHP/Laravel: $this->hasMany / $this->belongsTo（およびその他のEloquentリレーション）と scope* メソッド

リポジトリ: https://github.com/lilite572-cyber/context-slim

追加のフレーズはプロジェクトルートの .contextslimrc に記述します:

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

entry_patterns（デフォルト: index / cli / main / app / server）は、--signatures-only がなくても通常の関数本体を保持します。依存ファイルは空洞化されます。--signatures-only（またはMCPの signaturesOnly: true）を渡すと、重要でないものはすべて空洞化されます。

インストール / 公開

npm i
npm test
npm run build

バイナリ: context-slim → ./dist/cli.js、context-slim-mcp → ./dist/mcp.js。npm: @idmxgne/context-slim。GitHub: lilite572-cyber/context-slim。ライセンス: MIT。

ライセンス

MIT