ReMe/docs/zh/reference/cli.md

title	description
CLI 参考	ReMe 命令行语法、服务调用、配置覆盖与插件命令。

CLI 参考

ReMe 的基本语法是：

reme ACTION key=value ...

启动应用

默认采用两阶段：在一个终端启动服务，再在另一个终端调用 Job。以下启动命令任选一条，并保持运行：

reme start
reme start config=demo
reme start workspace_dir=/data/reme service.port=8181

普通 start 启动配置中的 Service；省略 config 时使用 default，需要其他配置时再显式指定。

调用 Job

在另一个终端调用，Action 名就是 Job 名；CLI 会发现正在运行的服务配置：

reme help
reme health_check
reme search query="项目决策" limit=10
reme read path=digest/wiki/project.md start_line=1 end_line=80

复杂值使用 JSON：

reme auto_memory \
  session_id=example \
  messages='[{"role":"user","content":"记住这条偏好"}]'

服务选择参数 backend、transport、host、port、timeout、command、args 和 show_metadata 只用于构造客户端，不会泄漏到 Job 参数。

配置覆盖

reme start \
  config=/path/to/custom.yaml \
  service.port=8181 \
  service.web_enabled=false \
  plugins='["auto-fin"]'

参数前的 - 或 -- 可以省略。嵌套键使用点号，数组和对象使用 JSON。

服务发现

reme find_reme

成功时输出可复用的服务信息；找不到服务时不会自动启动新进程。

插件命令

插件包管理是本地命令，不经过 HTTP 或 MCP：

reme plugins list
reme plugins show auto-fin
reme plugins validate auto-fin
reme plugins install plugins/auto-fin
reme plugins uninstall auto-fin

完整说明见插件管理。

发现当前能力

默认 Job 参数见 Job API 参考。运行配置可能由插件和自定义 YAML 改变，因此自动化程序应优先调用：

reme help
reme app_config

无服务单次执行

脚本需要执行一个 Job 后退出时，可以使用一次性 CLI Service：

reme start config=default job=search query="关键词" limit=5

start job=<name> 通过正常应用生命周期在本地运行 Job，然后退出；它不会调用已经运行的服务。 常规交互示例采用上面的两阶段流程。