hog

A lazygit-style terminal dashboard for GitHub Issues. Keyboard-driven, single-line rows, no context switching.

What it does

hog board --live opens a five-panel TUI that shows all your GitHub Project issues across repos. Navigate with j/k, pick up issues, change statuses, comment, search, and open details — without ever touching a browser.

The layout is inspired by lazygit: a narrow left column for repos and statuses, a wide issues list in the middle, a detail panel on the right, and an activity feed at the bottom.

Quick Start

npm install -g @ondrej-svec/hog
hog init        # interactive setup (picks up gh auth automatically)
hog board --live

Requirements: Node.js 22+ and the GitHub CLI authenticated via gh auth login.

Panel Layout

┌──────────────┬─────────────────────────────────┬──────────────────┐
│ [1] Repos    │ [3] Issues                      │ [0] Detail       │
│ [2] Statuses │  (main panel, full issue list)  │  (selected item) │
└──────────────┴─────────────────────────────────┴──────────────────┘
│ [4] Activity                                                       │
└────────────────────────────────────────────────────────────────────┘

Switch between panels with 0–4. The detail panel and activity feed only appear on wider terminals (≥120 cols and ≥140 cols respectively).

Features

Issue list

Each issue fits on a single line with fixed-width columns:

▶ #199   Frontend ↔ Backend integration spec…  [M] [p:H]  unassigned      3d
  #205   UI elements displaying in Cz…         [M] [p:H]  unassigned      1d

Column	Width	Content
Cursor	2	`▶` when selected
Number	7	`#1234`
Title	dynamic	truncated to fit panel width
Labels	13	up to 2 compact abbreviations: `[bug]`, `[p:H]`, `[M]`, `[WIP]`
Assignee	10	login or `unassigned`
Date	10	target date (`today`, `in 4d`, `3d overdue`) or age (`2h`, `5m`)

Labels are abbreviated automatically: size:M → [M], priority:high → [p:H], work:* → [WIP], enhancement → [enh].

Navigation

Key	Action
`j` / `k`	Down / up
`↓` / `↑`	Down / up
`Tab` / `Shift+Tab`	Next / previous section
`0`–`4`	Jump to panel
`Space`	Toggle section collapse (on header) or enter multi-select (on issue)
`Enter`	Open in browser (issue) or toggle collapse (section)
`0`	Detail panel — full-screen overlay on narrow terminals, focus side panel on wide
`C`	Collapse all sections
`?`	Toggle help overlay
`q`	Quit

Issue actions

Key	Action
`p`	Pick up issue — assign to yourself + optional TickTick task
`a`	Assign issue to yourself (no-op if already assigned to anyone)
`u`	Undo last reversible action
`e`	Edit issue in `$EDITOR` — change assignee, title, status, labels, body
`m`	Change project status
`l`	Add / remove labels
`c`	Add comment
`ctrl+e`	Open `$EDITOR` for a multi-line comment
`y`	Copy issue URL to clipboard
`n`	Create issue (form wizard)
`I`	Create issue from natural language
`f`	Focus mode (Pomodoro timer)

Board controls

Key	Action
`/`	Search issues by title
`r` / `R`	Refresh now

Multi-select

Press Space on any issue to enter multi-select, then:

Key	Action
`Space`	Toggle item
`Enter` / `m`	Bulk action menu (status, assign, label)
`Escape`	Exit multi-select

Multi-select is constrained to a single repo (GitHub API requirement).

Natural Language Issue Creation

Press I to open the natural language input. Type a plain-English description:

fix auth timeout on mobile #backend #bug @alice due friday

hog extracts:

Field	Token	Example
Labels	`#word`	`#backend`, `#bug`
Assignee	`@user`	`@alice`, `@me`
Due date	`due <expr>`	`due friday`, `due end of month`, `due 2026-03-01`
Title	everything else	`fix auth timeout on mobile`

A live preview shows the parsed fields before you confirm with Enter. Labels are validated against the repo's actual label list.

LLM enhancement (optional)

With an OpenRouter API key, hog sends ambiguous input to an LLM for richer title cleanup. Heuristic tokens always take priority — LLM only fills gaps.

hog config ai:set-key sk-or-...   # store key
hog config ai:clear-key            # remove
hog config ai:status               # show active provider

Or use environment variables (take priority over stored key):

export OPENROUTER_API_KEY=sk-or-...
# or
export ANTHROPIC_API_KEY=sk-ant-...

Commands

`hog board`

hog board --live                    # interactive TUI
hog board --json                    # full board as JSON
hog board --mine --json             # only my assigned issues
hog board --backlog --json          # only unassigned issues
hog board --repo owner/repo --json  # filter by repo
hog board --profile work --live     # use a named profile

`hog issue`

hog issue create "fix login bug #backend due friday" --repo owner/repo
hog issue create "add dark mode" --repo owner/repo --dry-run   # preview
hog issue create "add dark mode" --repo owner/repo --json      # structured output

`hog pick`

Assign an issue to yourself and optionally create a linked TickTick task.

hog pick owner/repo/145

`hog task`

Manage TickTick tasks (requires TickTick to be enabled).

hog task list
hog task add "Ship the feature"
hog task add "Bug fix" -p high -t "urgent"
hog task complete <taskId>
hog task update <taskId> --title "New title" -p medium
hog task delete <taskId>
hog task projects                   # list TickTick projects
hog task use-project <projectId>    # set default project

`hog config`

hog config show

# Repos
hog config repos
hog config repos:add owner/repo --project-number 1 --status-field-id PVTSSF_xxx --completion-type closeIssue
hog config repos:rm reponame

# TickTick
hog config ticktick:enable
hog config ticktick:disable

# AI
hog config ai:set-key sk-or-...
hog config ai:clear-key
hog config ai:status

# Profiles
hog config profile:create work
hog config profile:delete work
hog config profile:default work

`hog init`

Interactive setup. Detects your GitHub user, discovers your repos and project IDs, and optionally configures TickTick and an AI key.

hog init            # first-time setup
hog init --force    # overwrite existing config

`hog sync`

Sync GitHub issue status with TickTick task completion.

hog sync run            # run sync
hog sync run --dry-run  # preview
hog sync status         # show current mappings

Configuration

Config: ~/.config/hog/config.json (created by hog init, schema version 3).

{
  "version": 3,
  "repos": [
    {
      "name": "owner/repo",
      "shortName": "repo",
      "projectNumber": 1,
      "statusFieldId": "PVTSSF_xxx",
      "completionAction": { "type": "closeIssue" },
      "statusGroups": ["In Progress", "In Review", "Todo,Backlog"]  // optional
    }
  ],
  "board": {
    "refreshInterval": 60,   // seconds (min 10)
    "backlogLimit": 20,
    "assignee": "your-github-login",
    "focusDuration": 1500    // seconds (25 min default)
  },
  "ticktick": {
    "enabled": false         // set true to enable TickTick sync
  },
  "profiles": {},
  "defaultProfile": ""
}

Credentials (TickTick OAuth token, OpenRouter key) live in ~/.config/hog/auth.json with 0600 permissions.

Status groups

hog auto-detects status columns from your GitHub Project. Override per-repo with statusGroups:

"statusGroups": ["In Progress", "In Review", "Todo,Backlog"]

Each entry becomes a board section. Comma-separated values merge into one section (header = first value). Terminal statuses (Done, Shipped, Closed, etc.) are always hidden.

Profiles

Switch board configs for different contexts:

hog config profile:create work
hog config profile:default work
hog board --profile personal --live

Agent-friendly

Every command supports --json for structured output. This makes hog scriptable and usable by AI agents:

hog board --mine --json | jq '.issues[] | select(.labels[] | .name == "bug")'
hog issue create "fix login bug #backend @alice due friday" --repo owner/repo --json

How it works

GitHub data — always synchronous via execFileSync("gh", ...). No GitHub tokens or REST API calls; gh CLI handles auth.
TickTick data — async HTTP via the TickTick Open API. OAuth token stored in auth.json.
Rendering — Ink (React for CLIs). Each panel is an Ink component; rows are pre-truncated in JS so Ink never wraps text.
Auto-refresh — setInterval re-fetches in the background; age indicator turns yellow (>2 min) then red (>5 min).

Contributing

git clone https://github.com/ondrej-svec/hog
cd hog
npm install
npm run dev -- board --live    # run from source
npm run test                   # vitest
npm run ci                     # typecheck + lint + tests (what CI runs)

Toolchain: TypeScript (strict), Biome for lint/format, tsup for bundling, Vitest for tests. 80% coverage threshold enforced.

Filenames must be kebab-case. noExplicitAny is an error. Use import type for type-only imports.

Run a single test file:

npx vitest run src/board/components/issue-row.test.tsx

Requirements

Node.js 22+
GitHub CLI (gh) — authenticated via gh auth login
TickTick account — optional
OpenRouter API key — optional, for AI-enhanced issue creation

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 130 Commits
.github		.github
bin		bin
docs		docs
src		src
todos		todos
.editorconfig		.editorconfig
.gitignore		.gitignore
.nvmrc		.nvmrc
.release-please-manifest.json		.release-please-manifest.json
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
biome.json		biome.json
compound-engineering.local.md		compound-engineering.local.md
package-lock.json		package-lock.json
package.json		package.json
release-please-config.json		release-please-config.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts
vitest.config.ts		vitest.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

hog

What it does

Quick Start

Panel Layout

Features

Issue list

Navigation

Issue actions

Board controls

Multi-select

Natural Language Issue Creation

LLM enhancement (optional)

Commands

`hog board`

`hog issue`

`hog pick`

`hog task`

`hog config`

`hog init`

`hog sync`

Configuration

Status groups

Profiles

Agent-friendly

How it works

Contributing

Requirements

License

About

Uh oh!

Releases 33

Packages

Uh oh!

Contributors

Uh oh!

Languages

License

ondrej-svec/hog

Folders and files

Latest commit

History

Repository files navigation

hog

What it does

Quick Start

Panel Layout

Features

Issue list

Navigation

Issue actions

Board controls

Multi-select

Natural Language Issue Creation

LLM enhancement (optional)

Commands

hog board

hog issue

hog pick

hog task

hog config

hog init

hog sync

Configuration

Status groups

Profiles

Agent-friendly

How it works

Contributing

Requirements

License

About

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 33

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`hog board`

`hog issue`

`hog pick`

`hog task`

`hog config`

`hog init`

`hog sync`

Packages