# Hogli

> PostHog developer CLI and repo tooling reference.

PostHog developer CLI and repo tooling reference. Use when the user mentions hogli, asks about repo CLI tools, bin scripts, Makefiles, how to run/build/test/lint, or any dev environment commands.

- Page: https://ss33.ai/skills/posthog/hogli-50407169415
- Publisher: posthog
- Category: [Software Development](https://ss33.ai/skills/category/software-development-t44z8z) › [Developer docs & tooling](https://ss33.ai/skills/category/software-development-t44z8z/developer-docs-and-tooling-nich6w)
- License: MIT
- Source: https://github.com/posthog/posthog/blob/73b18ec19bc5551ab3eee0aaf747a13965f3157f/.agents/skills/hogli/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/posthog/hogli-50407169415

# 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