mcpField
H
hogli

hogli

github.com/posthogDevelopment40.5k259 installsUpdated today
Repository

About hogli

hogli is PostHog’s unified development CLI, bringing repository scripts, bin commands, and tooling under one entry point. It also documents process-log locations and troubleshooting references for PostHog development stacks.

Key features

  1. 01Run repository scripts and tools through one CLI
  2. 02View available commands with hogli --help
  3. 03Locate logs for detached and TUI launches
  4. 04Use hogli doctor:report for phrocs logs
  5. 05Find command definitions and documentation

Use cases

  1. 01Running PostHog development commands
  2. 02Troubleshooting a phrocs startup failure
  3. 03Inspecting process output from a development stack
  4. 04Looking up the source of a CLI command

Install

Copy the command and run it in a terminal.

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

After installing, type/hogliin Claude Code to confirm it loaded.

Details

From the project README

hogli - PostHog Developer CLI

Unified CLI for PostHog development. Wraps all repo scripts, bin commands, and tooling behind a single entry point. There is no Makefile — hogli is the equivalent.

Run hogli --help to get the full, current command list. Run hogli <command> --help for any subcommand.

Process logging (for agents/debugging)

Where logs land depends on how the stack was launched:

Detached (hogli up -d) — phrocs writes files under .posthog/.generated/logs/ on every boot:

  • phrocs.log — the daemon's own stdio; the place to look when phrocs died at startup and the phrocs MCP tools are unreachable.
  • <process>.log — per-process output (truncated on each start), where <process> matches the phrocs process key (see bin/mprocs.yaml).
  • hogli doctor:report prints the phrocs.log path and tails its last lines.

TUI with hogli dev:setup --log, then hogli start — adds a tee wrap per process:

  • /tmp/posthog-<process>.log — full stdout+stderr; persists in the generated config until dev:setup is re-run without --log.

When the phrocs MCP is reachable, prefer mcp__phrocs__get_process_logs over grepping files.

Key references

  • hogli.yaml — command definitions (source of truth)
  • tools/hogli-commands/hogli_commands/ — PostHog-specific lazy Click command modules
  • tools/hogli/README.md — framework documentation
  • tools/hogli-commands/README.md — PostHog commands documentation

Comments

Markdown supported