@adlc/cli

中文文档
1.12.0发布于 2026/10/10MITES Module构建来源已验证近 30 天下载 8148

Umbrella dispatcher for the @adlc suite - one install, one adlc <tool> command surface.

原始使用文档
文档目录5 节
  1. Why this exists
  2. Resolution model
  3. Usage
  4. Exit codes
  5. ADLC phase

@adlc/cli

The umbrella dispatcher for the ADLC suite. It provides one stable command surface for Codex skills, hooks, CI, and humans:

adlc <tool> [args...]
adlc run <phase> [args...]
adlc accept [args...]

The dispatcher is a router. It adds no behavior to a tool run: argv is forwarded verbatim and the child exit code is propagated unchanged.

Why this exists

ADLC packages publish independently, but an agent harness needs a single stable prefix. A skill or hook that shells out to twenty different binaries is brittle, slower to document, and easier to route around. @adlc/cli installs the suite and makes every gate reachable through adlc <tool>.

Resolution model

The dispatcher resolves package-local binaries from its own @adlc/* dependencies. It does not search the user's PATH for tool names, so stale global binaries cannot silently satisfy a gate.

Usage

adlc --help
adlc --version
adlc spec-lint spec.md --json
adlc rails-guard --ticket T1 --record --json
adlc run p5 --ticket T1 --dir .adlc --json
adlc accept --ticket T1 --packet .adlc/packet.json --dir .adlc --json

Exit codes

Exit codes mirror the underlying tool:

  • 0: gate passes or command succeeds.
  • 1: operational error.
  • 2: gate fails.

Dispatcher-level failures, such as an unknown tool or missing package, exit 1.

ADLC phase

Cross-cutting. This is the delivery and invocation layer for the ADLC Codex integration.

版本与发布记录

@adlc/cli 共发布 15 个版本,首次发布于 2026/06/23;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.0latest2026/10/1027 天前
1.11.12026/09/091 个月前
1.11.02026/08/252 个月前
1.10.02026/08/112 个月前
1.9.02026/08/092 个月前
1.8.02026/08/082 个月前

关于 @adlc/cli 的常见问题

@adlc/cli 是什么?

Umbrella dispatcher for the @adlc suite - one install, one adlc <tool> command surface.

如何安装 @adlc/cli?

在项目目录运行 npm install @adlc/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 adlc,可以用 npx adlc 直接运行。

@adlc/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adlc__cli 是否存在。

@adlc/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@adlc/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@adlc/cli 可以商用吗?

@adlc/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@adlc/cli 的下载量有多少?

根据 npm 官方下载统计,@adlc/cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,148 次,日均约 272 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adlc/cli 还在维护吗?

最新版本 1.12.0 发布于 2026/10/10(27 天前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/06/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。