Show HN: Epiq – Distributed Git based issue tracker TUI
AIThis post was created with the assistance of artificial intelligence (AI).

TL;DR

Prime Big Deal Days · Oct 6–7Offer from Amazon

Get the latest gadgets delivered free — and shop member deals

  • Fast, free delivery on millions of items
  • Access to Prime Big Deal Days deals on October 6–7
  • Prime Video, Amazon Music and more included
Start your free Prime trial Free trial for eligible customers · Cancel anytime
As an affiliate, we earn on qualifying purchases.

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

Amazon

ASCII kanban board tools

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.

Amazon

vim-inspired project management tool

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.

HALLOWEEN

Halloween Picks

As an affiliate, we earn on qualifying purchases.

You May Also Like

GitHub and the crime against software

GitHub faces ongoing outages, security issues, and reliability failures, raising concerns about its role in modern software infrastructure and trust.

OpenAI brings its Codex coding app to mobile

OpenAI now allows ChatGPT users on Android and iOS to access Codex projects remotely, enhancing mobile coding management and security.

Serverless Computing 101: How to Run Code Without Servers

Discover how serverless computing enables effortless code deployment and scaling, unlocking new possibilities—continue reading to master this transformative approach.

Eight Everyday Algorithms Every Developer Should Hand‑Code Once

Keen developers will discover eight essential algorithms to master by hand, unlocking deeper understanding and practical benefits for everyday coding challenges.