@cursorx/cli 0.0.3

package/LICENSE

@@ -0,0 +1,133 @@
+CursorX End-User License Agreement (EULA)
+
+Version 1.0 — effective 2026-06-06
+
+Copyright (c) 2026 CursorX. All rights reserved.
+
+This End-User License Agreement (the "Agreement") is a legal agreement
+between you ("You" or "Licensee") and CursorX (the "Licensor") governing
+your use of the CursorX software, including its CLI, VS Code / Cursor
+extension, local router, and any associated patch components and
+documentation (collectively, the "Software").
+
+By installing, copying, downloading, accessing, or otherwise using the
+Software, You agree to be bound by the terms of this Agreement. If You do
+not agree to these terms, do not install or use the Software.
+
+
+1. LICENSE GRANT
+
+   Subject to Your compliance with this Agreement, the Licensor grants You
+   a personal, non-exclusive, non-transferable, non-sublicensable, revocable
+   license to install and use the Software on devices You own or control,
+   solely for Your own internal use in the manner intended by the Licensor.
+
+   No rights are granted to You other than those expressly set forth in
+   this Agreement.
+
+
+2. RESTRICTIONS
+
+   You shall not, and shall not permit, encourage, or assist any third
+   party to:
+
+   (a) reverse engineer, decompile, disassemble, deobfuscate, or otherwise
+       attempt to derive the source code, underlying ideas, algorithms,
+       file formats, protocols, or non-public APIs of the Software, except
+       to the extent such activity is expressly permitted by applicable
+       law notwithstanding this limitation;
+
+   (b) redistribute, sublicense, rent, lease, lend, sell, resell, host as
+       a service, mirror, or otherwise transfer the Software (or any
+       portion thereof) to any third party;
+
+   (c) repackage, modify, translate, adapt, or create derivative works of
+       the Software, except as expressly permitted by the Licensor in
+       writing;
+
+   (d) remove, alter, obscure, or fail to reproduce any copyright,
+       trademark, license, attribution, or other proprietary notice
+       contained in or on the Software;
+
+   (e) circumvent, disable, tamper with, or otherwise interfere with any
+       license verification, activation, integrity check, telemetry
+       restriction, or other security or compliance mechanism of the
+       Software;
+
+   (f) use the Software to violate the terms of service or acceptable use
+       policy of any third-party product or service (including but not
+       limited to Cursor), to engage in any unlawful activity, or to
+       infringe any third-party right.
+
+
+3. INTELLECTUAL PROPERTY
+
+   The Software is licensed, not sold. The Licensor and its licensors
+   retain all right, title, and interest in and to the Software, including
+   all intellectual property rights therein. This Agreement does not grant
+   You any rights to the Licensor's trademarks, service marks, or logos.
+
+
+4. THIRD-PARTY COMPONENTS
+
+   The Software incorporates third-party open-source components, each
+   governed by its own license. Such components are provided under their
+   respective licenses and are not subject to the restrictions in
+   Sections 1 through 3 of this Agreement insofar as those restrictions
+   would conflict with the third-party license. A list of third-party
+   components and their licenses is available upon request.
+
+
+5. DISCLAIMER OF WARRANTIES
+
+   THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTY
+   OF ANY KIND, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED
+   TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+   TITLE, AND NON-INFRINGEMENT. THE LICENSOR DOES NOT WARRANT THAT THE
+   SOFTWARE WILL BE UNINTERRUPTED, ERROR-FREE, SECURE, OR FREE OF HARMFUL
+   COMPONENTS, NOR DOES IT WARRANT ANY PARTICULAR RESULTS FROM YOUR USE
+   OF THE SOFTWARE.
+
+
+6. LIMITATION OF LIABILITY
+
+   TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL
+   THE LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+   CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR ANY LOSS OF
+   PROFITS, REVENUE, DATA, GOODWILL, OR BUSINESS OPPORTUNITY, ARISING OUT
+   OF OR RELATED TO THIS AGREEMENT OR YOUR USE OF (OR INABILITY TO USE)
+   THE SOFTWARE, WHETHER IN CONTRACT, TORT, OR OTHERWISE, EVEN IF ADVISED
+   OF THE POSSIBILITY OF SUCH DAMAGES.
+
+   THE LICENSOR'S TOTAL CUMULATIVE LIABILITY UNDER THIS AGREEMENT SHALL
+   NOT EXCEED THE GREATER OF (i) THE AMOUNT YOU PAID THE LICENSOR FOR THE
+   SOFTWARE IN THE TWELVE (12) MONTHS PRECEDING THE EVENT GIVING RISE TO
+   THE CLAIM, OR (ii) USD $50.
+
+
+7. TERM AND TERMINATION
+
+   This Agreement is effective until terminated. The Licensor may
+   terminate this Agreement immediately upon Your breach of any term
+   hereof. Upon termination, You must cease all use of the Software and
+   destroy all copies in Your possession or control. Sections 2 through 6
+   and Section 8 shall survive any termination of this Agreement.
+
+
+8. GENERAL
+
+   This Agreement constitutes the entire agreement between You and the
+   Licensor with respect to the Software and supersedes all prior or
+   contemporaneous communications, whether oral or written, regarding the
+   same. If any provision of this Agreement is held to be unenforceable,
+   the remaining provisions shall remain in full force and effect, and
+   the unenforceable provision shall be modified to the minimum extent
+   necessary to make it enforceable. No waiver of any breach shall
+   constitute a waiver of any subsequent breach.
+
+   The Licensor reserves the right to update this Agreement at any time.
+   Continued use of the Software after notice of changes constitutes
+   acceptance of the updated terms.
+
+
+For licensing inquiries, please contact: contact@cursorx.top

package/README.md

@@ -0,0 +1,99 @@
+# CursorX
+
+> **CursorX 让你在 Cursor 中用自己的 API Key 接入自定义模型；非官方，与 Cursor 官方无隶属关系。**
+>
+> **CursorX lets you connect your own model API keys to Cursor; unofficial, not affiliated with Cursor.**
+
+---
+
+## 是什么 / What is it
+
+CursorX 是一个**本地**的 Cursor 增强工具。它让你在 Cursor 中接入**自己配置的模型 API**与**自定义模型列表**，不论你是 Free 还是 Pro 计划。所有请求只走 `127.0.0.1`、所有 API Key 只入系统 Keychain、所有日志默认仅元数据、零远程上传。
+
+CursorX is a local enhancement tool for Cursor. It lets you use your own model API and a custom model list inside Cursor, regardless of your Cursor plan. All requests stay on `127.0.0.1`; API keys live only in your system keychain; logs are metadata-only by default; nothing leaves your machine.
+
+---
+
+## 安装 / Install
+
+```bash
+npx @cursorx/cli install
+```
+
+安装器会自动完成：
+
+1. 检测当前系统（macOS / Windows / Linux）与 Cursor 版本
+2. 在 `~/.cursorx/backups/<timestamp>/` 创建原始文件备份（带 SHA-256 校验，便于一键回滚）
+3. 安装 CursorX Extension 到你的 Cursor / VS Code
+4. 启动本地路由（监听 `127.0.0.1` 随机端口）
+
+The installer detects your OS and Cursor version, backs up touched files under `~/.cursorx/backups/<timestamp>/` with SHA-256 checksums, installs the extension into Cursor / VS Code, and starts the local router on `127.0.0.1`.
+
+---
+
+## 配置 / Configure
+
+打开 Cursor → 左侧 Activity Bar 点 **CursorX** 图标 → 打开控制面板：
+
+1. 在 **提供商 / Providers** 添加一个 Provider（Base URL + API Key，Key 自动存入 Keychain）
+2. 在 **模型 / Models** 给该 Provider 添加 1–2 个模型
+3. 在 **路由 / Routes** 把 chat 指向上面的模型
+4. 在 **状态 / Status** 打开 CursorX 总开关 → 完成
+
+Open Cursor → click the CursorX icon in the Activity Bar → in the Control Panel: add a provider with its Base URL and API key, add a model under it, point the chat route at that model, then toggle CursorX on.
+
+---
+
+## 卸载 / Restore / Uninstall
+
+```bash
+npx @cursorx/cli restore     # 回滚 Cursor 到安装前的原始文件（SHA-256 校验）
+npx @cursorx/cli uninstall   # restore + 清理 CursorX 数据
+```
+
+`restore` rolls Cursor back to its pre-install state using the SHA-256-verified backup. `uninstall` does the same and also removes CursorX's own data.
+
+---
+
+## 安全 / Security
+
+- **本地路由**硬编码绑定 `127.0.0.1`；不绑公网、不做反向代理。
+- **API Key 仅入系统 Keychain**（macOS Keychain / Windows Credential Manager / Linux Secret Service）——绝不写入 JSON / 日志 / 错误响应。
+- **日志默认仅元数据**：只记录请求 ID / 时间 / 模型 / 状态 / 延迟 / token 数，不记录 Prompt 内容。
+- **零远程上传**：日志、Prompt、代码均不离开本机；不内置 telemetry / analytics。
+- **唯一对外出站例外 = 授权校验**：启用付费授权时，CursorX 仅向自家授权服务发送 `授权码 + 不可逆设备哈希 + 平台 / 版本号`。绝不发送代码 / Prompt / API Key / Cursor 账号或 token。
+
+Router binds `127.0.0.1` only. API keys live only in the system keychain. Logs are metadata-only by default. No remote upload, no telemetry. The only outbound exception is license activation, which sends only the license key, an irreversible device hash, and platform/version to CursorX's own license service — never your code, prompts, API keys, or Cursor account tokens.
+
+---
+
+## 合规 / Compliance
+
+- CursorX **不**使用 Cursor 官方 Logo / 商标。
+- CursorX **不**作为「破解 Pro」「绕过 Pro」「解锁 Pro」类工具宣传；CursorX **不提供** Cursor 任何付费模型的访问能力，那些仍由 Cursor 服务器决定。
+- CursorX **不**修改 Cursor 服务器认证 / 不伪造订阅或支付状态 / 不读取 Cursor 账号或 token。
+- CursorX **不**承诺所有 Cursor 版本永久可用；Cursor 升级若改动相关路径，CursorX 会自动暂停并提示你重新适配。
+
+CursorX does not use Cursor's trademarks or logo. CursorX is not a "crack Pro" / "bypass Pro" / "unlock Pro" tool — it provides no access to Cursor's paid models, which remain gated by Cursor's own servers. CursorX does not touch Cursor's server-side authentication, subscription state, or account / session tokens. CursorX does not guarantee permanent compatibility — if Cursor changes the relevant paths, CursorX auto-pauses and prompts you to re-apply.
+
+---
+
+## 反馈 / Feedback
+
+Bug 报告 / 功能请求 / Bug reports / feature requests: <https://github.com/Runcoor/cursorx-issues/issues>
+
+提交诊断信息前请先在控制面板「设置 → 导出诊断包」生成脱敏版本。Before sharing diagnostics, export a redacted bundle from the Control Panel → Settings.
+
+---
+
+## 许可 / License
+
+专有 EULA（详 [`LICENSE`](LICENSE)）。允许个人非独占使用；禁止反向工程 / 再分发 / 重新打包 / 绕过授权校验。
+
+Proprietary EULA (see [`LICENSE`](LICENSE)). Personal non-exclusive use; reverse engineering / redistribution / repackaging / circumvention of license verification are prohibited.
+
+商务 / 授权咨询 / Commercial inquiries: <contact@cursorx.top>
+
+---
+
+CursorX · 2026-06