# Hold Rein

Hold Rein 是一个本地优先、模型无关的 AI Agent 工作台。它通过命令行启动本地运行时，并在浏览器中提供可交互的 Web 控制台。

## 安装

```bash
npm install @hold-rein/cli -g
```

## 核心能力

- 一行全局安装: 一条命令，终端即获 hold-rein 与 hr 命令。
- 本地运行时: hold-rein start 启动内置 API 与 Web 控制台，浏览器即用。
- 插件生态: plugin init 初始化插件，plugin install 一键安装到插件目录。
- 热重载开发: --plugin-dev 加载本地插件源码，变化时自动重载，调试零等待。
- 双命令等价: hold-rein 与 hr 完全等价，顺手即用，命令行驱动。
- 本地优先: 默认监听 127.0.0.1:3001，数据与运行时留在本地，安全可控。

## 常用命令

### hold-rein start

启动打包后的本地服务，加载 API 运行时与 Web 控制台。

示例：`hold-rein start --host 0.0.0.0 --port 4000`

### hold-rein plugin init

初始化一个新的 Hold Rein 插件包，生成项目基础文件。

示例：`hold-rein plugin init --name my-plugin`

### hold-rein plugin install <source>

安装一个插件包到本地插件目录。

示例：`hold-rein plugin install ./plugins/my-plugin`

## 重要页面

- https://hr.myapping.cn/docs - 安装、启动和插件开发文档。
- https://hr.myapping.cn/llms.txt - 面向 AI 工具的精选站点索引。
- https://hr.myapping.cn/llms-full.txt - 面向 AI 工具的全站 Markdown 内容合集。