@ai-setting/roy-agent-cli
Command-line interface for roy-agent. Provides non-interactive command execution.
工具链协作
| 工具 | 职责 | 使用场景 |
|---|---|---|
| pnpm | 包管理、依赖安装、发布 | pnpm install, pnpm publish |
| bunup | SDK bundle 编译 | bun run build |
| build-cli-dev.ts | Dev 构建（源码 sourcemap） | bun run build:cli:dev:single |
| build-cli-prod.ts | Prod 构建（standalone） | bun run build:cli:prod:single |
Build
构建模式
| 模式 | 命令 | 产物 | 说明 |
|---|---|---|---|
| SDK Bundle | bun run build | dist/index.js, dist/bin/roy-agent.js | bunup 编译，用于 npm 发布 |
| Dev | bun run build:cli:dev:single | dist/bin/roy-agent.js + sourcemap | 本地平台，调试用 |
| Prod Single | bun run build:cli:prod:single | dist/roy-agent-*/bin/roy-agent | 本地平台，standalone |
| Prod All | bun run build:cli:prod | dist/roy-agent-*/bin/roy-agent | 全平台 5 个，standalone |
Dev 模式
生成带有 sourcemap 的 bundle，日志可显示准确的 .ts 文件路径和行号。
bun run build:cli:dev:single
# 运行
bun packages/cli/dist/bin/roy-agent.js act "hello"
Prod 模式
生成 standalone 可执行文件。
# 本地平台
bun run build:cli:prod:single
# 全平台（linux-x64, linux-arm64, darwin-x64, darwin-arm64, windows-x64）
bun run build:cli:prod
Development
源码运行：
bun packages/cli/src/bin/roy-agent.ts
Usage
CLI Binary
# Interactive mode
roy-agent
# Execute task
roy-agent act "帮我写一个 hello world"
# With options
roy-agent act "任务" --model gpt-4 --quiet
SDK Import
import { runCli } from "@ai-setting/roy-agent-cli";
// Run CLI
await runCli();
Publishing
# 1. SDK bundle 编译（bunup）
bun run build
# 2. 发布到 npm
cd packages/cli
pnpm publish --access public
Dependencies
@ai-setting/roy-agent-core- Core SDK@ai-setting/roy-agent-coder-harness- LSP harnesschalk- Terminal colorsyargs- CLI argument parsing