mcpField
H
helmor-cli

helmor-cli

github.com/dohoooAgent 工作流1.3k2.0k 次安装14 周前更新
代码仓库

关于 helmor-cli

helmor-cli 是为 Helmor 用户和 Agent 提供的命令行使用指南，覆盖仓库、工作区、会话及 Agent 派发等操作，并说明如何按任务查阅命令帮助。

主要功能

  1. 01按子命令路由常见任务
  2. 02查看 CLI 状态与数据目录
  3. 03管理仓库和工作区
  4. 04检查会话与文件
  5. 05从命令行向 Agent 派发任务
  6. 06通过 stdio 运行 MCP 服务

适用场景

  1. 01从终端创建 Helmor 工作区
  2. 02查看会话或编辑器文件操作
  3. 03向 Agent 派发工作
  4. 04让其他运行时通过 MCP 调用 Helmor

MCP 相关

指南说明可用 `helmor mcp` 通过 stdio 将 Helmor 作为 MCP 服务运行，供其他 Agent 或运行时调用。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dohooo/helmor --skill helmor-cli

安装后在 Claude Code 中输入/helmor-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
break.md
helmor-help.md
restack.md
stack-spec.md
stacked-pr.md
scripts/
render_stack.py

详细介绍

Helmor CLI

使用此技能指导简单的终端优先 Helmor 工作流。回答应注重实用：优先提供一到两个具体命令，而不是冗长的 CLI 教程。

命令路由

根据 /helmor-cli 后面的第一个词进行路由：

  • restack — 在较低层发生更改或合并后，重新同步 PR 堆栈。遵循 references/restack.md。（这是合成器的 Restack 按钮会发送的内容。）
  • stack — 将大型更改规划并构建为一组相互依赖的 PR。遵循 references/stacked-pr.md。
  • break — 将你已在当前工作区中编写的更改拆分为一组较小且相互依赖的 PR，并先与用户确认拆分粒度。遵循 references/break.md。
  • 其他任何内容（或没有参数）——普通 Helmor CLI 任务；请使用下面的二进制名称指南和命令参考。

二进制名称（发布版与开发版）

以下示例使用字面名称 helmor——发布版用户 PATH 中的二进制文件名称。

  • 发布版构建：使用 helmor <subcommand> 调用命令。
  • 开发版构建：不要假设 PATH 中存在 helmor-dev。在 Helmor 基于 worktree 的开发工作流中，每个 worktree 都有自己的 target/debug/helmor-cli，而共享的 /usr/local/bin/helmor-dev 符号链接（如果存在）只能指向其中一个。具体而言：
    • 如果你是在 Helmor 中运行的 Agent，系统提示词已提供要使用的确切 CLI 调用方式（通常是类似 <worktree>/src-tauri/target/debug/helmor-cli 的绝对路径）。请原样调用——不要通过 which、file 或 --version 重新验证。
    • 如果你是在终端操作的用户，请运行 <your-worktree>/src-tauri/target/debug/helmor-cli <subcommand>（或当前 Helmor 构建所使用的路径）。

无论构建类型如何，其他命令格式都相同。

初步检查

  1. 检查是否已安装 CLI，以及它使用哪种数据模式：
helmor cli-status
  1. 检查当前活动的数据目录和数据库：
helmor data

如果输出将由脚本或其他工具解析，请使用 --json。

CLI 安装与更新

请将 Helmor CLI 的安装和更新视为 Beta 功能。

  • 安装或修复受管理的 CLI 入口时，优先使用 Helmor 桌面应用的入门设置／设置中的 Components 面板。
  • 使用 helmor cli-status 验证 PATH 条目是否指向当前由应用管理的 CLI。
  • 除非 helmor --help 或某个子命令帮助页面中确实存在，否则不要臆造稳定的独立安装／更新命令。
  • 如果用户遇到阻碍，请让他们运行 helmor cli-status 并分享输出；如果你正在 Helmor 仓库内工作，也可以检查应用的 Components 面板。

Helmor 技能的安装与更新

请将 Helmor 技能的安装和更新视为 Beta 版应用管理流程。

  • 安装或更新捆绑的 Helmor 技能时，优先使用 Helmor 桌面应用的入门设置／设置中的 Components 面板。
  • 不要臆造 helmor skills 命令；顶层 CLI 帮助目前并未提供该命令。
  • 如果用户要求更新仓库内捆绑的 Helmor 技能，请直接编辑技能文件，并使用技能验证工具进行验证。
  • 面向用户的技能内容应保持简洁，并优先使用英文，除非用户明确要求使用其他语言。

常见任务

管理仓库和工作区

使用以下命令组进行本地优先的项目设置和工作区编排：

helmor repo --help
helmor workspace --help

创建工作区时，优先使用明确的仓库名称和简洁的用途标签：

helmor workspace new --repo helmor
检查会话和文件

使用会话查看对话历史，使用文件进行编辑器界面操作：

helmor session --help
helmor files --help
向 Agent 发送提示词

如果用户想从终端派发任务，请使用 send：

helmor send --help

自动化时优先使用 JSON 输出：

helmor --json send --help
集成和本地工具

使用相关的命令组：

helmor github --help
helmor scripts --help
helmor models --help
MCP 服务

通过 stdio 将 Helmor 作为 MCP 服务运行：

helmor mcp

当其他 Agent／运行时需要通过 Model Context Protocol 调用 Helmor 时使用此方式。

命令参考

需要查看完整的顶层 helmor --help 命令列表时，请阅读 references/helmor-help.md。

要查看命令组的确切标志，请运行该命令组的帮助命令，而不要猜测：

helmor <command> --help

评论

支持 Markdown