mcpField
H
hogli

hogli

github.com/posthog开发40.5k259 次安装今天更新
代码仓库

关于 hogli

hogli 是 PostHog 的统一开发命令行工具，将仓库脚本、bin 命令和工具集中到一个入口。它还说明开发栈的进程日志位置，并提供排障参考。

主要功能

  1. 01通过单一命令行入口运行仓库脚本和工具
  2. 02使用 hogli --help 查看可用命令
  3. 03查找分离运行和 TUI 启动时的日志
  4. 04用 hogli doctor:report 查看 phrocs 日志
  5. 05定位命令定义和文档

适用场景

  1. 01运行 PostHog 开发命令
  2. 02排查 phrocs 启动失败
  3. 03检查开发栈的进程输出
  4. 04查找命令行指令的定义来源

安装

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

$npx skills add https://github.com/posthog/posthog --skill hogli

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

详细介绍

hogli - PostHog 开发者命令行

用于 PostHog 开发的统一命令行。将仓库中的所有脚本、bin 命令和工具封装在单一入口之后。没有 Makefile —— hogli 就是它的等价物。

运行 hogli --help 获取完整且最新的命令列表。对任何子命令运行 hogli <command> --help。

进程日志（供 Agent/调试使用）

日志存放位置取决于技术栈的启动方式：

分离模式（hogli up -d） —— phrocs 在每次启动时都会将文件写入 .posthog/.generated/logs/ 下：

  • phrocs.log —— 守护进程自身的 stdio；当 phrocs 在启动时崩溃且 phrocs MCP 工具无法访问时，这里是查看的地方。
  • <process>.log —— 每个进程的输出（每次启动时截断），其中 <process> 与 phrocs 进程键匹配（参见 bin/mprocs.yaml）。
  • hogli doctor:report 会打印 phrocs.log 的路径并输出其最后几行。

使用 hogli dev:setup --log 的 TUI，然后 hogli start —— 为每个进程添加 tee 包装：

  • /tmp/posthog-<process>.log —— 完整的 stdout+stderr；会保留在生成的配置中，直到在不带 --log 的情况下重新运行 dev:setup。

当 phrocs MCP 可访问时，优先使用 mcp__phrocs__get_process_logs，而不是对文件进行 grep。

关键参考

  • hogli.yaml —— 命令定义（事实来源）
  • tools/hogli-commands/hogli_commands/ —— PostHog 特定的延迟 Click 命令模块
  • tools/hogli/README.md —— 框架文档
  • tools/hogli-commands/README.md —— PostHog 命令文档

评论

支持 Markdown