👋 Introduction

The gh family is a set of npm packages that put GitHub pull-request work in the terminal. They are layered so the logic lives once: a core that shells out to the gh CLI and returns plain data, a pure workflow layer that decides whose move a row is, Ink components that draw it, and thin CLIs and a cockpit host on top.

@kud/gh            core: talks to gh, returns plain data
  @kud/gh-workflow   whose move it is, sorting, grouping, filtering
    @kud/gh-ink        Ink components and the inbox shell
      @kud/gh-cockpit    the host that assembles tabs
@kud/gh-pr-comments · gh-pr-health · gh-webhook-replay    thin CLIs

Everything needs the gh CLI installed and authenticated, and Node 22 or newer.

What's here

• 🧱 Core (@kud/gh) — transport primitives, the inbox query, health, review threads, webhooks
• 🧭 Workflow (@kud/gh-workflow) — whose-move banding, row layout and search, with no renderer or transport
• 🎨 Ink components (@kud/gh-ink) — panels, health glyphs and the inbox extension API
• 🛫 Cockpit (@kud/gh-cockpit) — build your own PR dashboard from tabs, filters and drill-ins
• ⌨️ CLIs — gh-pr-comments, gh-pr-health and gh-webhook-replay