{"_id":"@agents-npm-packages/supercompress","_rev":"8-f3d9f9404e19386100872b95abda11b4","name":"@agents-npm-packages/supercompress","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"@agents-npm-packages/supercompress","version":"1.0.0","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"license":"MIT","_id":"@agents-npm-packages/supercompress@1.0.0","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"homepage":"https://supercompress.dev/docs/coding-agents","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"bin":{"supercompress":"bin/supercompress.js"},"dist":{"shasum":"20e69c599edb3182da19afbb940b4d0b6e44a45c","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.0.tgz","fileCount":9,"integrity":"sha512-3TEDW4hmgCHcObp4VSLeuF9l3nf7wgpR4SfsYpOcEmfSUzdQr0FJ1mrZI5Y64NtDhY2++XWpD8yJc8z1gSXvTA==","signatures":[{"sig":"MEQCIB6DvXid7lYcj9KMMJdvU/iE8yDMc4DgB0Aq79qXpM6OAiBYrRvigA0GzmZ6sxytYFiFQlP9DlSXVW2zhMxxD8bF4w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59890},"main":"src/server.js","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"175ed7d11be405ae058b5c12de1de04193a774f1","scripts":{"stop":"node bin/supercompress.js stop","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","status":"node bin/supercompress.js status","postinstall":"echo '✓ SuperCompress installed. Run `supercompress setup` to get started.'"},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"repository":{"url":"git+https://gitlab.com/arjunkshah/supercompress.git","type":"git","directory":"packages/proxy"},"_npmVersion":"11.7.0","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","directories":{},"_nodeVersion":"22.23.0","dependencies":{"express":"^4.21.0","node-fetch":"^2.7.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/supercompress_1.0.0_1784185859375_0.8298740105421654","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agents-npm-packages/supercompress","version":"1.0.1","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"license":"MIT","_id":"@agents-npm-packages/supercompress@1.0.1","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"homepage":"https://supercompress.dev/docs/coding-agents","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"bin":{"supercompress":"bin/supercompress.js"},"dist":{"shasum":"46d6b1b7546b3c045d4b27d2e7821f34fc752b31","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.1.tgz","fileCount":9,"integrity":"sha512-NjFCBKDdZjwgZITUywLgufqEdcbCo/Ny3KXqivkjruS5CQhtT/arPiqKf16uq1q8/VcQ2vhTckJSaj0ofuBqPQ==","signatures":[{"sig":"MEUCIQD/6UVCwAyWTPrRYHYRQ6ayVZ1H3t+Z6LyL9nZL0Ut+6AIga6hBPumlyUQ8CkVo57HU/PsaKE4EE/RZgquY8H+edF4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59898},"main":"src/server.js","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"175ed7d11be405ae058b5c12de1de04193a774f1","scripts":{"stop":"node bin/supercompress.js stop","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","status":"node bin/supercompress.js status","postinstall":"echo '✓ SuperCompress installed. Run `supercompress setup` to get started.'"},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"repository":{"url":"git+https://gitlab.com/arjunkshah/supercompress.git","type":"git","directory":"packages/proxy"},"_npmVersion":"11.7.0","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","directories":{},"_nodeVersion":"22.23.0","dependencies":{"express":"^4.21.0","node-fetch":"^2.7.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/supercompress_1.0.1_1784311610185_0.6037600022060012","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@agents-npm-packages/supercompress","version":"1.0.2","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"license":"MIT","_id":"@agents-npm-packages/supercompress@1.0.2","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"homepage":"https://supercompress.dev/docs/coding-agents","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"bin":{"supercompress":"bin/supercompress.js","supercompress-mcp":"src/mcp.js"},"dist":{"shasum":"0bc28693ca1b0add20ba3676f113160fdbc62474","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.2.tgz","fileCount":14,"integrity":"sha512-8Ci62FwVifKO9E6AbnRBA+KWq2iRIIzwfmLhDtzupGlwcq2v6MLhJFBSM/XV/PLxAgC23H6oAcgGCJIllJ9aEg==","signatures":[{"sig":"MEUCIQCqZ9dxPK00DqQgZOU5iGGqVrvbYVuUuQsGQHOtxvKL3gIgGqyUQS9VDRQL8MkaXhm8UwqscHSXw9GSoGunY4Uihqc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":482692},"main":"src/server.js","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"12203cb11ebb62cf9d075090e687001e1253bd89","scripts":{"stop":"node bin/supercompress.js stop","test":"node test/smoke.js","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","status":"node bin/supercompress.js status","postinstall":"node bin/install.js"},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"repository":{"url":"git+https://gitlab.com/arjunkshah/supercompress.git","type":"git","directory":"packages/proxy"},"_npmVersion":"11.7.0","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"express":"^4.21.0","node-fetch":"^2.7.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/supercompress_1.0.2_1784897768284_0.06163089185367432","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@agents-npm-packages/supercompress","version":"1.0.3","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"license":"MIT","_id":"@agents-npm-packages/supercompress@1.0.3","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"homepage":"https://supercompress.dev/docs/coding-agents","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"bin":{"supercompress":"bin/supercompress.js","supercompress-mcp":"src/mcp.js"},"dist":{"shasum":"ad944056dd317883b9343c8d284da120f4e77761","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.3.tgz","fileCount":14,"integrity":"sha512-Li2b9Z6L/eOXETIl+6TJ3iIW5hVPJDkX7LNkHKFEGNbbA00tizApz5uI5rVMro+2LJRgyNwWJTjygh0bpwmMYw==","signatures":[{"sig":"MEQCIGGqRLXbRlOtiBO97QABNyAWGCpHADQcqeeOfQR25IwxAiAxbMEECWp7UUQLGAfEZGiHLwl0Xs1Pl3Xvp8NnS2Fang==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":483884},"main":"src/server.js","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"12203cb11ebb62cf9d075090e687001e1253bd89","scripts":{"stop":"node bin/supercompress.js stop","test":"node test/smoke.js","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","status":"node bin/supercompress.js status","postinstall":"node bin/install.js"},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"repository":{"url":"git+https://gitlab.com/arjunkshah/supercompress.git","type":"git","directory":"packages/proxy"},"_npmVersion":"11.7.0","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"express":"^4.21.0","node-fetch":"^2.7.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/supercompress_1.0.3_1784897970811_0.369836078085388","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@agents-npm-packages/supercompress","version":"1.0.4","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"license":"MIT","_id":"@agents-npm-packages/supercompress@1.0.4","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"homepage":"https://supercompress.dev/docs/coding-agents","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"bin":{"supercompress":"bin/supercompress.js","supercompress-mcp":"src/mcp.js"},"dist":{"shasum":"e3d3718df2112c12d790688a4a1e562824d6d5ea","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.4.tgz","fileCount":14,"integrity":"sha512-0tIByMtxQCjBoVGPQG9tSFUINZ79q9+jzFKZBRW6Su/DfTpKpshp7ETDym+9VA5150cVwxIOtrFvYS8cWS3U+A==","signatures":[{"sig":"MEYCIQCph2KV8verGCCkWZ6NdBhTHf+n9A/xUBbDDA1fk0RmpgIhAKJYnw35hA/CXHZiQnqr/YqnoX2KaxEpIz0QVIKrOUSz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":484036},"main":"src/server.js","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"12203cb11ebb62cf9d075090e687001e1253bd89","scripts":{"stop":"node bin/supercompress.js stop","test":"node test/smoke.js","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","status":"node bin/supercompress.js status","postinstall":"node bin/install.js"},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"repository":{"url":"git+https://gitlab.com/arjunkshah/supercompress.git","type":"git","directory":"packages/proxy"},"_npmVersion":"11.7.0","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"express":"^4.21.0","node-fetch":"^2.7.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/supercompress_1.0.4_1784898070656_0.2856928025428962","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@agents-npm-packages/supercompress","version":"1.0.5","description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"homepage":"https://supercompress.dev/docs/coding-agents","repository":{"type":"git","url":"git+https://gitlab.com/arjunkshah/supercompress.git","directory":"packages/proxy"},"license":"MIT","type":"commonjs","main":"src/server.js","bin":{"supercompress":"bin/supercompress.js","supercompress-mcp":"src/mcp.js"},"scripts":{"test":"node test/smoke.js","setup":"node bin/supercompress.js setup","start":"node bin/supercompress.js start","stop":"node bin/supercompress.js stop","status":"node bin/supercompress.js status","postinstall":"node bin/install.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","express":"^4.21.0","node-fetch":"^2.7.0"},"engines":{"node":">=18.0.0"},"gitHead":"12203cb11ebb62cf9d075090e687001e1253bd89","_id":"@agents-npm-packages/supercompress@1.0.5","bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"_nodeVersion":"25.3.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-hxLO+EtSHcz60Cvo56piJybClZBL/ykczkUXQX/O+o9x9AyUyoblMwyau3cgcjZaFC2m/ibZE43UH3+q5njvYg==","shasum":"3ea0202ab19bc5dd3b8cbb50d737e3d138daa075","tarball":"https://registry.npmjs.org/@agents-npm-packages/supercompress/-/supercompress-1.0.5.tgz","fileCount":14,"unpackedSize":484126,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHrGXdpyP+HTSDspfeUyDSVCfA6RIr0whQqsMDUCIPljAiEA/8AwJx3bQ3LaFQS77W9vLZA8UaEyUncWiUF6BjQiifM="}]},"_npmUser":{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"},"directories":{},"maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/supercompress_1.0.5_1784898176742_0.4362812391601243"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-16T07:10:59.226Z","modified":"2026-07-24T13:02:57.062Z","1.0.0":"2026-07-16T07:10:59.512Z","1.0.1":"2026-07-17T18:06:50.325Z","1.0.2":"2026-07-24T12:56:08.434Z","1.0.3":"2026-07-24T12:59:30.940Z","1.0.4":"2026-07-24T13:01:10.870Z","1.0.5":"2026-07-24T13:02:56.896Z"},"bugs":{"url":"https://gitlab.com/arjunkshah/supercompress/issues"},"license":"MIT","homepage":"https://supercompress.dev/docs/coding-agents","keywords":["supercompress","prompt-compression","cursor","windsurf","continue","cline","claude-code","token-compression","llm-cost"],"repository":{"type":"git","url":"git+https://gitlab.com/arjunkshah/supercompress.git","directory":"packages/proxy"},"description":"SuperCompress — one install, all your coding agents. Auto-compresses LLM context to save ~65% on token costs.","maintainers":[{"name":"agents-npm-packages","email":"arjunkshah21@gmail.com"}],"readme":"# SuperCompress\n\n**One install. All your coding agents. ~65% fewer LLM tokens. Forever.**\n\n```\nnpm install -g supercompress-cli\n```\n\nThe install itself registers the MCP plugin for detected agents. `supercompress setup` opens the SuperCompress account connection flow, auto-detects installed agents, configures the supported ones, and starts the proxy. No raw API-key copy step is required.\n\nIt also installs a standard MCP plugin as `supercompress-mcp`. MCP-capable clients such as Codex, Cursor, Claude Code, and Gemini CLI can use the same compression tool while keeping their existing login flow.\n\nThe proxy works when an agent sends an OpenAI-compatible or Anthropic-compatible API request through its configurable base URL. It does not intercept an agent's own hosted subscription backend. In particular, Codex sessions authenticated only with ChatGPT login do not provide an OpenAI API key that this local proxy can forward; use Codex API-key mode for compression.\n\n## How It Works\n\nSuperCompress sits between your coding agent and the LLM provider, compressing every prompt before it reaches the model:\n\n```\n[Cursor/Windsurf/etc.] → POST /v1/chat/completions → [SuperCompress]\n                                                           ↓\n                                              Compresses context via API\n                                                           ↓\n                                              Forwards to OpenAI/Anthropic\n                                                           ↓\n                                              Returns response (with savings!)\n```\n\nEvery compression call is authenticated against your **SuperCompress account** and billed per your plan (Free → Starter → Pro). Heavy users hit the free tier fast and upgrade naturally.\n\n## One-Time Setup\n\n```bash\n# Install globally\nnpm install -g supercompress-cli\n\n# Run the interactive setup\nsupercompress setup\n```\n\nThe setup command will:\n1. Open the SuperCompress dashboard and link your account with a one-time code\n2. Detect installed Cursor, Windsurf, Continue, Cline, Claude Code, Codex, and Aider\n3. Configure supported agent settings and print manual steps for agents without a safe config surface\n4. Register as a background service (auto-starts on login)\n\nSetup reports an agent as configured only after its local setting is written. Run `supercompress status` and check request logs before relying on it.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `supercompress setup` | Interactive setup (account link, agent config, background service, proxy start) |\n| `supercompress start` | Start the compression server |\n| `supercompress stop` | Stop the compression server |\n| `supercompress status` | Check if the server is running |\n| `supercompress restart` | Restart the server |\n| `supercompress uninstall` | Remove SuperCompress and revert all agent configs |\n| `supercompress-mcp` | Run the MCP plugin over stdio for any MCP-compatible agent |\n\nAfter installation, run `supercompress setup`. It opens the dashboard for sign-in, links your account with a one-time code, auto-configures the detected agents, and starts the proxy. The key is never sent to the coding agent or provider.\n\n## MCP Plugin\n\nFor any MCP-compatible client, register:\n\n```json\n{\n  \"mcpServers\": {\n    \"supercompress\": {\n      \"command\": \"supercompress-mcp\"\n    }\n  }\n}\n```\n\nMCP is the portable integration layer. Clients without MCP support or a configurable model endpoint cannot be intercepted by an external plugin.\n\n## Manual Configuration\n\nIf auto-detection doesn't find your agent, configure it manually:\n\n### Cursor\nSettings → Models → **Override OpenAI Base URL**: `http://localhost:8080/v1`\n\n### Windsurf\nSettings → **API Endpoint**: `http://localhost:8080/v1`\n\n### Continue (VS Code)\nEdit `~/.continue/config.json`:\n```json\n{\n  \"models\": [{\n    \"title\": \"SuperCompress\",\n    \"provider\": \"openai\",\n    \"model\": \"gpt-4o\",\n    \"apiBase\": \"http://localhost:8080/v1\",\n    \"apiKey\": \"sk-supercompress\"\n  }]\n}\n```\n\n### Cline (VS Code)\nExtension settings → API Provider: **OpenAI Compatible** → Base URL: `http://localhost:8080/v1`\n\n### Claude Code\n```bash\nexport ANTHROPIC_BASE_URL=http://localhost:8080\nclaude\n```\n\nThis applies to Claude API-key mode. Claude's hosted login/subscription backend may bypass `ANTHROPIC_BASE_URL` or use credentials that are not valid for the public Anthropic API, in which case the proxy cannot forward the request.\n\n### Aider\n```bash\naider --openai-api-base http://localhost:8080/v1\n# or\nexport OPENAI_API_BASE=http://localhost:8080/v1\n```\n\n### Codex authentication\n\nCodex API-key mode works with `openai_base_url` in `~/.codex/config.toml`:\n\n```toml\nopenai_base_url = \"http://localhost:8080/v1\"\n```\n\nStart Codex with an OpenAI API key available to it. A Codex ChatGPT subscription login is a different backend and is not proxyable by this local API adapter.\n\n## What You Get\n\n| Before | After |\n|--------|-------|\n| 4,000 tokens per Cursor request | ~1,400 tokens (~65% less) |\n| $0.04 per GPT-4 Turbo request | ~$0.014 per request |\n| $200/month per heavy user | ~$70/month |\n| Context window fills up fast | 3x more effective context space |\n\n## How We Make Money (Transparent)\n\nThe server calls `POST /api/v1/compress` on the SuperCompress API for every compression. That call is authenticated by your API key and counts against your plan's monthly token quota:\n\n| Plan | Price | Tokens/Month | Typical Usage |\n|------|-------|-------------|---------------|\n| Free | $0 | 100K | 1–2 days of Cursor |\n| Starter | $10/mo | 5M | 1–2 months |\n| Pro | $20/mo | 15M | Sweet spot for daily devs |\n| Business | $60/mo | Unlimited | Teams on shared server |\n\nA heavy Cursor user generates 50K–500K tokens/day. The free tier runs out fast — and the value you get (saving 65% on your $20–200/mo LLM bill) far outweighs the $10–20 plan price.\n\n## Requirements\n\n- Node.js 18+ (`node -v`)\n- A SuperCompress account (get a free API key at https://supercompress.dev/dashboard)\n\n## Privacy\n\nThe server runs **locally** on your machine. Your provider API keys (OpenAI, Anthropic) never leave your computer. Only the context text is sent to the SuperCompress API for compression.\n\n## Uninstall\n\n```bash\nsupercompress uninstall\n```\n\nThis stops the server, reverts all agent configurations, and removes the config directory.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}