跳转到内容

命令行 CLI

CLI 与桌面端共用本地资产管理能力,适合脚本和批量操作。桌面安装程序不会自动安装 prompthub 命令。

从当前稳定发布下载 CLI 的 .tgz 包,然后安装实际下载的文件:

Terminal window
pnpm add -g ./prompthub-cli-0.6.2.tgz
prompthub --version
prompthub --help

开发者也可在 PromptHub 源码仓库安装依赖后打包:

Terminal window
pnpm pack:cli
pnpm add -g ./apps/cli/prompthub-cli-*.tgz
Terminal window
prompthub prompt list --output table
prompthub prompt search "review" --output json
prompthub skill scan
prompthub mcp list
prompthub plugin list
prompthub agent list

通过每组命令的 --help 查看参数。首次写入前确认指向正确工作区;CLI 更改后,在桌面端刷新工作区查看结果。

命令 用途
prompt / folder 查询、编辑、组织、标签、关系、输出格式和版本
skill 完整包导入、扫描、文件操作、来源更新、版本与分发
mcp 服务配置、来源、检查、环境变量导入和目标应用
plugin 插件来源、完整包、更新、版本与分发
agent Agent 配置与身份;配置读取会脱敏敏感值
rules 扫描、读写、版本、导入和导出
ai 服务商、模型和功能路由
workspace 完整工作区 JSON bundle 导入导出
sync 已配置远端的状态、推送和拉取

必须指定文件路径:

Terminal window
prompthub workspace export --file ./workspace-backup.json

导出包含 Prompt、关系、输出格式、Skill 及其文件、MCP、Plugins、Rules 和媒体。CLI bundle 与桌面全量 .phub.gz 备份格式不同。

导入到已确认的空工作区:

Terminal window
prompthub workspace import --file ./workspace-backup.json

已有数据时导入会要求显式处理覆盖,先备份,不要为了绕过提示随意追加清空参数。

参数 含义
--output json / --output table 机器可读或表格输出
--summary / --full 默认摘要;明确需要时返回完整内容
--quiet 成功不输出,错误仍写 stderr
--data-dir <path> 指定 userData 目录
--app-data-dir <path> 指定应用数据根目录

不要把私钥、令牌或密码写进脚本或资源包。Skill 包处理会应用内置忽略规则及根目录 .prompthubignore,导入前仍需检查内容。