Show HN: Epiq – Distributed Git based issue tracker TUI
Epiq is a local-first, distributed issue tracker that works inside any Git repository. It uses Git under the hood for synchronization and event-sourcing for immutable, traceable state. The TUI is keyboard-centric with vim-like navigation, filters, and kanban boards. It supports MCP for AI agent workflows.
Repo-nativeissues live with the work
Local-firstinstant edits, sync at will
Event-sourcedimmutable, traceable
MCP-readybuilt for agent workflows
Why Epiq
Bringing devX to project management.
Epiq optimizes for flow: keyboard navigation, command history, filters, autocompletion, and plain Git synchronization.
hjkl
Keyboard centric
Navigate boards, issues, swimlanes, and contexts with vim-like movement. Or cheat with arrow keys.
git
Distributed by default
Epiq uses Git under the hood, with isolated worktrees and state branches, so teams can collaborate without introducing another central service.
log
Traceable state
Changes are appended as events, replayed deterministically, and designed to converge. Inspect what happened yesterday, last week, or one year ago.
The model
Local first. Sync at will. Or automatically.
Create, move, filter, close, reopen, and sync issues without tab-switching. Epiq keeps local interaction instant while allowing you to sync explicitly or automatically.
inside any Git repo
epiq
create work
:new issue Add keyboard shortcuts
narrow the board
:filter tag prio
synchronize distributed state
:sync
What you get
$1
No account requiredInitialize in a Git repo and keep moving.
$2
Visual ASCII kanban boardsKanban in the terminal, navigated, filtered, and edited quickly.
$3
Conflict-aware collaborationUser-scoped append-only event logs prevents merge pain and converge in memory.
$4
Agent interactionsThe MCP server lets AI tools interact with Epiq in a predictable way.
Issue tracking should be smooth.
- probably someone
Install
Start in two commands.
Install globally, enter any Git repository, and run Epiq. First launch opens an interactive setup wizard.
npm install --global epiq cd your-existing-repo-with-remote-tracking epiq
:visit github repository