Terminal TUI · pohunek

Features

What it does

Work

Joins Linear, GitHub and pohunek sessions into one list of work items, with the next action for each.

Sessions, Hosts and Activity

Sessions grouped by Needs you, Running, Ready and Unavailable. Attach, stop and remove from the same view. Hosts and Activity use the public pohunek --json commands.

Keyboard and mouse

Tab and 1 to 4 switch views, arrows move the selection, Enter opens. Press ? for the keys.

Install

Get it running

Install pohunek-work (Linux and macOS, needs Bun)

The release archive is a Bun program. These lines verify it, put it under ~/.local/lib and add a pohunek-work command to ~/.local/bin.

shell

gh release download plugin-v0.7.1 -R zajca/pohunek-work -p 'pohunek-work-plugin-0.7.1-noarch.tar.gz*'
sha256sum -c pohunek-work-plugin-0.7.1-noarch.tar.gz.sha256
gh attestation verify pohunek-work-plugin-0.7.1-noarch.tar.gz --repo zajca/pohunek-work
tar -xzf pohunek-work-plugin-0.7.1-noarch.tar.gz
mkdir -p ~/.local/lib ~/.local/bin
rm -rf ~/.local/lib/pohunek-work && mv pohunek-work-plugin-0.7.1-noarch ~/.local/lib/pohunek-work
printf '#!/bin/sh\nexec bun "$HOME/.local/lib/pohunek-work/plugin/pohunek-work.js" "$@"\n' > ~/.local/bin/pohunek-work
chmod +x ~/.local/bin/pohunek-work
pohunek-work doctor

Configure and run

doctor reports a missing config until you write ~/.config/pohunek/plugins/work/config.toml. Every key is required, there are no hidden defaults; the plugin guide lists them. Projects go in ~/.config/pohunek/plugins/work/projects/<label>.toml.

shell

pohunek-work doctor
pohunek-work tui

Notes

Status: plugin-v0.7.1 is released, and the plugin README still lists the Sessions, Hosts and Activity views as in progress. Check the release notes for the exact scope.

Every surface is a client of the same public CLI and protocol. See the other surfaces or the docs. Project home: https://github.com/zajca/pohunek.