@mk-co/neox-cli 0.0.0-reserved → 2.2.0

package/LICENSE

@@ -0,0 +1,254 @@
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+  A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate.  Many developers of free software are heartened and
+encouraged by the resulting cooperation.  However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+  The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community.  It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server.  Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+  An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals.  This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU Affero General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the

package/README.md

@@ -1,12 +1,42 @@
-# @mk-co/neox-cli — Name Reserved
+# Neox CLI
 
-This package name is **reserved** by MK-CO and intentionally empty.
+> Professional AI code assistant — agent loop, tool use, multi-provider routing.
 
-The previous public versions of `@mk-co/neox-cli` were unpublished on 2026-05-27
-after we decided to move to a closed-source distribution model (similar to
-[@anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code)).
+```bash
+npm install -g @mk-co/neox-cli
+neox --help
+```
 
-**There is no working code in this package.**
+## Quick start
 
-If you were depending on the old public version, please contact MK-CO for
-alternative distribution. Do not install this package expecting functionality.
+```bash
+neox                          # 启动交互模式
+neox -p "fix the login bug"   # 单次任务
+neox --model gpt-5.4 ...      # 指定模型
+```
+
+## Configuration
+
+See https://neox.dev/docs for full configuration / authentication / commands.
+
+## How this package is structured
+
+This is a **thin npm wrapper** (20 KB). The actual CLI is a single-file binary
+shipped via platform-specific optional dependencies:
+
+- `@mk-co/neox-cli-darwin-arm64`
+- `@mk-co/neox-cli-darwin-x64`
+- `@mk-co/neox-cli-linux-x64`
+- `@mk-co/neox-cli-linux-arm64`
+- `@mk-co/neox-cli-win32-x64`
+
+`npm install` only downloads the binary for your platform (~60-100 MB).
+
+Same distribution model as `@anthropic-ai/claude-code`.
+
+## License
+
+UNLICENSED · proprietary · © MK-CO
+
+Source code is closed. Reverse engineering / redistribution of binaries
+prohibited. Contact MK-CO for licensing.

package/bin/neox

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../cli-wrapper.cjs');

package/cli-wrapper.cjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * @mk-co/neox-cli · cli-wrapper
+ *
+ *   主包安装后, bin/neox 是个 symlink → @mk-co/neox-cli-${platform}/neox.
+ *   理论上 npm bin shim 直接走 symlink 就行, 不一定需要 wrapper.
+ *
+ *   但保留这个 wrapper 是给两种 fallback 路径:
+ *
+ *     1. 用户 main 包当 require('@mk-co/neox-cli') module 用 (尽管罕见) —
+ *        package.json `"main": "./cli-wrapper.cjs"` 让 require 拿到这个 stub,
+ *        不会拿到 binary 然后 SyntaxError.
+ *
+ *     2. 用户 install 时 postinstall 失败 (e.g. --no-optional), bin/neox 是
+ *        placeholder, 直接跑 `neox` 时 placeholder script 调本 wrapper 退出
+ *        + 友好提示.
+ *
+ *   binary 跑起来后, 这个 wrapper 完全不在 critical path, 所以零业务逻辑.
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const SUPPORTED = {
+  'darwin-arm64':   '@mk-co/neox-cli-darwin-arm64',
+  'darwin-x64':     '@mk-co/neox-cli-darwin-x64',
+  'linux-x64':      '@mk-co/neox-cli-linux-x64',
+  'linux-arm64':    '@mk-co/neox-cli-linux-arm64',
+  'win32-x64':      '@mk-co/neox-cli-win32-x64',
+};
+
+function findBinary() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const pkgName = SUPPORTED[platformKey];
+  if (!pkgName) {
+    process.stderr.write(`neox: 不支持当前平台 ${platformKey}.\n`);
+    process.stderr.write(`支持的平台: ${Object.keys(SUPPORTED).join(', ')}\n`);
+    process.exit(1);
+  }
+  try {
+    const pkgRoot = path.dirname(require.resolve(`${pkgName}/package.json`));
+    const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
+    const binary = path.join(pkgRoot, exeName);
+    if (fs.existsSync(binary)) return binary;
+  } catch { /* fall through */ }
+
+  process.stderr.write(`neox: 平台子包 ${pkgName} 没装 (可能用了 --no-optional).\n`);
+  process.stderr.write(`修复: npm install -g ${pkgName}\n`);
+  process.exit(1);
+}
+
+/* 直接 exec, 跨进程 forward stdio + signals. */
+const { spawn } = require('node:child_process');
+const binary = findBinary();
+const child = spawn(binary, process.argv.slice(2), {
+  stdio: 'inherit',
+  windowsHide: false,
+});
+
+const passSignal = (sig) => () => {
+  try { child.kill(sig); } catch { /* ignore */ }
+};
+process.on('SIGINT', passSignal('SIGINT'));
+process.on('SIGTERM', passSignal('SIGTERM'));
+process.on('SIGHUP', passSignal('SIGHUP'));
+
+child.on('exit', (code, sig) => {
+  if (sig) {
+    /* 让 parent 也以同样 signal 死, shell 才能正确 detect Ctrl-C 退出 */
+    process.kill(process.pid, sig);
+  } else {
+    process.exit(code ?? 0);
+  }
+});
+
+child.on('error', (e) => {
+  process.stderr.write(`neox: 无法启动 binary: ${e.message}\n`);
+  process.exit(2);
+});
+
+module.exports = { findBinary };

package/install.cjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/**
+ * @mk-co/neox-cli · postinstall
+ *
+ *   npm 装完主包 + 当前 platform 的 optional dep 之后跑这里:
+ *     · 检测当前 platform = "${process.platform}-${process.arch}"
+ *     · 找到 @mk-co/neox-cli-${platform} 的 native binary 路径
+ *     · symlink (Unix) / copy (Windows) 到 ./bin/neox 给 npm bin shim 用
+ *
+ *   设计跟 @anthropic-ai/claude-code 同套路 — 主包零业务代码, 真 binary 在
+ *   平台子包里, 用户 `npm install -g` 时 optional deps 自动只装当前 platform.
+ *
+ *   失败容错:
+ *     · platform 不支持 → 退 1 + 友好提示 (列出我们支持的 platforms)
+ *     · platform 包没装 → 友好提示用户 manual install (常见: 用了 --no-optional)
+ *
+ *   不抛 throw, 因为 npm postinstall 抛了会让整个 install 显红, 但其实没 fatal.
+ */
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const SUPPORTED = {
+  'darwin-arm64':   '@mk-co/neox-cli-darwin-arm64',
+  'darwin-x64':     '@mk-co/neox-cli-darwin-x64',
+  'linux-x64':      '@mk-co/neox-cli-linux-x64',
+  'linux-arm64':    '@mk-co/neox-cli-linux-arm64',
+  'win32-x64':      '@mk-co/neox-cli-win32-x64',
+};
+
+function log(msg) {
+  process.stdout.write(`[neox-cli postinstall] ${msg}\n`);
+}
+function warn(msg) {
+  process.stderr.write(`[neox-cli postinstall] ⚠ ${msg}\n`);
+}
+
+function main() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const pkgName = SUPPORTED[platformKey];
+
+  if (!pkgName) {
+    warn(`不支持当前平台 ${platformKey}.`);
+    warn(`支持的平台: ${Object.keys(SUPPORTED).join(', ')}`);
+    warn(`你的 neox 命令会找不到, 请联系 MK-CO 支持其他平台.`);
+    return; /* 不退 1, 让 npm install 整体成功, 用户跑 neox 时再报错 */
+  }
+
+  /* 找 platform sub-package 的 binary. node_modules 解析路径取决于安装方式
+   * (-g vs 项目级), 用 require.resolve 让 npm 自己决定. */
+  let binarySrc;
+  try {
+    /* 期待: node_modules/@mk-co/neox-cli-${platform}/neox (Unix) or neox.exe (Win) */
+    const pkgRoot = path.dirname(require.resolve(`${pkgName}/package.json`));
+    const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
+    binarySrc = path.join(pkgRoot, exeName);
+    if (!fs.existsSync(binarySrc)) {
+      warn(`平台子包已装但 binary 不在 ${binarySrc} — 可能 publish 出错.`);
+      return;
+    }
+  } catch (e) {
+    warn(`平台子包 ${pkgName} 未安装 (${e.code || 'unknown'}).`);
+    warn(`如果你用了 npm install --no-optional / yarn install --ignore-optional,`);
+    warn(`手动安装: npm install -g ${pkgName}`);
+    return;
+  }
+
+  /* 创建 bin/neox 指向 platform binary. Unix 用 symlink, Windows 用 copy. */
+  const binDir = path.join(__dirname, 'bin');
+  fs.mkdirSync(binDir, { recursive: true });
+  const exeName = process.platform === 'win32' ? 'neox.exe' : 'neox';
+  const binDest = path.join(binDir, exeName);
+
+  try {
+    if (fs.existsSync(binDest) || fs.lstatSync(binDest).isSymbolicLink?.()) {
+      fs.rmSync(binDest, { force: true });
+    }
+  } catch { /* ignore */ }
+
+  try {
+    if (process.platform === 'win32') {
+      /* Windows: 不能 symlink (要管理员), 直接 copy */
+      fs.copyFileSync(binarySrc, binDest);
+    } else {
+      fs.symlinkSync(binarySrc, binDest);
+      fs.chmodSync(binDest, 0o755);
+    }
+    log(`installed ${platformKey}: ${path.relative(process.cwd(), binDest)} → ${path.relative(process.cwd(), binarySrc)}`);
+  } catch (e) {
+    warn(`无法 ${process.platform === 'win32' ? 'copy' : 'symlink'} binary: ${e.message}`);
+    warn(`手动 fix: ${process.platform === 'win32' ? 'copy' : 'ln -s'} "${binarySrc}" "${binDest}"`);
+  }
+}
+
+try { main(); } catch (e) {
+  warn(`unexpected: ${e?.message || String(e)}`);
+  /* 仍然 exit 0, 不让 npm install 失败 */
+}

package/package.json

@@ -1,9 +1,45 @@
 {
   "name": "@mk-co/neox-cli",
-  "version": "0.0.0-reserved",
-  "description": "Name reserved · 闭源包不再公开发布. See readme.",
+  "version": "2.2.0",
+  "description": "Neox CLI · Professional AI code assistant",
   "license": "UNLICENSED",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./cli-wrapper.cjs",
+  "bin": {
+    "neox": "./bin/neox"
+  },
+  "files": [
+    "bin/",
+    "install.cjs",
+    "cli-wrapper.cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node install.cjs"
+  },
+  "optionalDependencies": {
+    "@mk-co/neox-cli-darwin-arm64": "2.2.0",
+    "@mk-co/neox-cli-darwin-x64":   "2.2.0",
+    "@mk-co/neox-cli-linux-x64":    "2.2.0",
+    "@mk-co/neox-cli-linux-arm64":  "2.2.0",
+    "@mk-co/neox-cli-win32-x64":    "2.2.0"
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "agent",
+    "code-assistant"
+  ],
+  "author": "MK-CO",
+  "homepage": "https://neox.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mk-co/neox-private"
   }
 }