Zero CLI (@ksconsole/zero)

一个极简、可组合的命令行工具，提供：

• 安全扫描：基于 @ksconsole/security 的一键扫描能力
• 本地代码执行透传：将参数原样转发给本机的 kode 可执行程序

使用场景：在一条命令里完成安全扫描，或把任务交给本地 Agent/CLI（kode）。

安装

npm i -g @ksconsole/zero

安装完成后将获得命令：zero

快速开始

# 运行安全扫描（具体参数由 @ksconsole/security 提供）
zero scan

# 透传给本机的 `kode`：以下会执行系统中的 `kode` 命令
zero code "write a hello world"

命令说明

• zero scan [..args]

  • 调用 @ksconsole/security 的扫描子命令，参数原样传入。
  • 示例：
    • zero scan
    • zero scan --help（查看 @ksconsole/security 的完整参数与说明）

• zero code <args...>

  • 将所有参数原样透传给本机的 kode 可执行文件。
  • 标准输入/输出与退出码均与子进程保持一致。
  • 示例：
    • zero code "init a typescript project"
    • zero code --version

先决条件

• Node.js：建议 18+，推荐 20（本项目构建目标为 Node 20）。
• 使用 zero code 时，系统需已安装 kode 并加入 PATH。
  • 若未安装，将看到错误提示：无法启动 kode，请确认已安装并在 PATH 中。
  • 请参考 kode 的官方文档获取安装方式。

退出码与日志

• zero scan 与 zero code 的退出码会尽量与其子进程保持一致：
  • 正常完成：返回子进程退出码（一般为 0）。
  • 运行时被信号终止：会输出终止信号并返回非 0。

开发与构建

本仓库使用 TypeScript 与 esbuild。

• 入口文件：src/cli.ts
• 构建命令：

npm run build

构建产物：dist/cli.mjs（由 package.json 的 bin 字段指向，命令名为 zero）。

许可证

MIT

致谢

• 安全扫描能力由 @ksconsole/security 提供。