basebuilder-cli

Command-line tool for the BaseBuild Builder API.

Install

npm install -g basebuilder-cli

Run With npx

npx basebuilder-cli build "我需要一个招聘管理应用"

Build From Text

basebuilder build "我需要一个招聘管理应用，流程是职位发布、简历筛选、面试评估、Offer审批、入职报到"

The command streams progress until Builder returns batch_complete.

Use --json when an agent or script should parse JSON Lines:

basebuilder build "我需要一个招聘管理应用" --json

Build From JSON

basebuilder build --input request.json --json

--json emits JSON Lines. Builder events are emitted as received. CLI keepalive lines use event: "cli_keepalive" so agents can tell the command is still waiting.

Example request:

{
  "client_batch_id": "batch-example",
  "items": [
    {
      "client_item_id": "req-example-001",
      "user_requirement": "我需要一个招聘管理应用，流程是职位发布、简历筛选、面试评估、Offer审批、入职报到"
    }
  ],
  "defaults": {
    "language": "zh",
    "with_generate_flowchart": false,
    "extra": {
      "prompt_variant": "current"
    }
  },
  "max_concurrency": 1,
  "continue_on_error": true
}

Status

basebuilder status esm_20260423_120000_abcd1234
basebuilder status esm_20260423_120000_abcd1234 --json

API Reference

basebuilder reference

Options

--base-url <url>              Defaults to BASEBUILD_BASE_URL or http://127.0.0.1:1128
--header <key:value>          Extra request header. Can be repeated.
--timeout <ms>                HTTP timeout for setup and short requests.
--keepalive-interval <sec>    Build keepalive interval. Defaults to 60. Use 0 to disable.

Shortcut text builds use language=zh, with_generate_flowchart=false, max_concurrency=1, and continue_on_error=true unless overridden.