Show HN: Epiq – Distributed Git based issue tracker TUI

TL;DR

Epiq is a new terminal-based issue tracker that leverages Git for distributed collaboration, offers ASCII kanban boards, and emphasizes local-first, event-sourced workflows. It aims to streamline project management for developers who prefer command-line tools.

Epiq has been released as a terminal-based, Git-integrated issue tracker designed for developers who prefer command-line workflows. It renders issue boards as ASCII art, stores work as immutable event logs, and synchronizes via Git, eliminating the need for SaaS or web interfaces.

Developed to optimize developer experience (devX) in project management, Epiq provides a vim-inspired interface for navigating and editing issues, boards, and swimlanes with keyboard commands. It uses Git under the hood, employing isolated worktrees and state branches to enable distributed collaboration without central servers. Changes are recorded as append-only event logs, making history traceable and conflict-aware.

Installation is straightforward: run two commands—one to install globally via npm, and another to initialize within an existing Git repository. Once set up, users can create, move, filter, close, reopen, and synchronize issues directly from the terminal, with instant local interaction and optional explicit or automatic syncs. Epiq features ASCII kanban boards, filters, autocompletion, and vim-like navigation, all designed to facilitate fast, keyboard-driven workflows.

Why It Matters

This development matters because it offers a new approach to issue tracking tailored for developers who prioritize local-first, command-line tools, and distributed workflows. By removing dependency on web-based SaaS solutions, Epiq aims to reduce friction, improve traceability, and enable seamless collaboration through Git, potentially influencing how teams manage projects in terminal-centric environments.

Amazon

terminal issue tracker software

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background

Traditional issue trackers are often web-based, centralized, and rely on SaaS platforms, which can introduce friction, privacy concerns, or dependency on external services. Epiq builds on the trend of terminal tools and local-first workflows, aligning with the developer community’s interest in lightweight, integrated solutions. Its design draws inspiration from vim, event sourcing, and Git, emphasizing traceability and conflict resolution in distributed settings. The project was introduced on Hacker News as an open-source tool aimed at improving developer experience in project management.

“Epiq is designed to bring devX to project management, optimizing for flow with keyboard navigation, command history, filters, and plain Git synchronization.”

— Epiq developer

“It uses Git under the hood, with isolated worktrees and state branches, so teams can collaborate without introducing another central service.”

— Epiq project description

PATboard Kanban Board and Scrum Board – Full Toolset with 137 Scrum Cards for Whiteboard – Agile Kit, Agile Board, Kanban Board Kit – Scrum Tools, Project Management Tools

PATboard Kanban Board and Scrum Board – Full Toolset with 137 Scrum Cards for Whiteboard – Agile Kit, Agile Board, Kanban Board Kit – Scrum Tools, Project Management Tools

✅ POWERFUL SCRUM & KANBAN KIT: This professional PATboard full toolset is the ultimate scrum and kanban kit…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What Remains Unclear

It is not yet clear how well Epiq handles complex conflict scenarios in practice or how it scales with large teams. User adoption and community feedback are still emerging, and integration with existing project workflows may vary.

VIM ToolsHBR5 Ratchet

VIM ToolsHBR5 Ratchet

Package Dimensions: 18.084 H x 2.032 L x 6.019 W (centimetres)

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

What’s Next

Next steps include community testing, gathering user feedback, and potential feature enhancements such as improved conflict resolution, integrations with other tools, and UI refinements. Developers may also explore contributing to the open-source project or adopting it in their workflows.

Amazon

Git-based issue tracker

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Key Questions

How do I install Epiq?

Run two commands: first, install globally with npm install --global epiq. Then, navigate to your existing Git repository and run epiQ to initialize and start using it.

Does Epiq require a server or cloud service?

No, Epiq operates entirely within your local Git repository. It does not depend on any external SaaS or centralized server for collaboration.

Can I use Epiq with my existing project workflows?

Yes, Epiq is designed to integrate seamlessly with your current Git workflows, providing issue tracking directly in the terminal without additional setup.

What are the main features of Epiq?

Key features include ASCII kanban boards, vim-inspired keyboard navigation, event-sourced immutable logs, conflict-aware collaboration, and optional automatic synchronization via Git.

You May Also Like

Why Developers Need Better Debugging Habits

Great debugging habits can transform your coding process, but the key to mastering them lies in understanding what truly makes a difference.

Stealing from Biologists to Compile Haskell Faster

A Haskell compiler optimization problem led to leveraging RNA folding algorithms, revealing unexpected cross-disciplinary solutions to code efficiency.

Show HN: Nibble

Nibble is a new systems programming language written in C, designed to generate LLVM IR without external dependencies, supporting advanced features and graphical demos.

How Contract Testing Helps Distributed Teams

Contract testing helps you work smoothly across distributed teams by verifying that…