Repolode
Submit
ljtn

ljtn/epiq

A self-hosted, Git-backed issue tracker that stores tickets as an event log, so you can replay how a board changed over time.

Open-source alternative to:JiraLinear

View on GitHubWebsite
Stars
549
Forks
22
Open issues
0
Last commit
yesterday

What is it?

Epiq is an issue tracker that lives inside your repository rather than in a hosted service. It stores board state as an immutable, append-only event log that is versioned and synchronized through Git, so the board works offline and syncs when you run a sync command.

Because every change is an event, you can replay the board to see what moved, when, and by whom. Commits are linked to tickets with an Epiq-Ref line or a ref prefix in the subject, and each ticket's Code tab shows the linked commits with their diffs. Epiq can also read commits from other repositories connected to the board.

Epiq has a terminal UI, a browser GUI started with `epiq gui`, and an MCP server (`epiq-mcp`) so agents such as Claude Code can read and update tickets. It is installed via a shell script or npm and is released under the MIT license.

Key features

  • 01Stores tickets as an append-only event log synchronized through Git.
  • 02Replays board history to see what changed, when, and by whom.
  • 03Links commits to tickets via Epiq-Ref lines or subject prefixes and shows diffs in the ticket.
  • 04Provides a terminal UI and a browser GUI backed by the same engine.
  • 05Exposes an MCP server so AI agents can read and update tickets.

Use cases

  • Tracking issues inside a code repository without a separate SaaS account.
  • Reviewing what an AI agent did during an unattended work session.
  • Working on issues offline and syncing changes later through Git.
  • Linking code changes and their diffs directly to the tickets they address.

Quick start

  1. 1

    Install the binary with the official install script from the README

  2. 2

    Or install via npm

    npm install --global epiq
  3. 3

    Verify the installation

    epiq --version
  4. 4

    Inside a Git repository, run Epiq to start the setup wizard

    epiq

Things to know

  • Requires a Git repository, and sync relies on your existing git credentials.

In collections

MCP serversCLI & terminal toolsPrivacy & local-first tools

Topics

#issue-tracker#git-based#kanban#offline-first#tui#event-sourcing#mcp#task-manager

FAQ

What is epiq?
A self-hosted, Git-backed issue tracker that stores tickets as an event log, so you can replay how a board changed over time. Epiq is an issue tracker that lives inside your repository rather than in a hosted service. It stores board state as an immutable, append-only event log that is versioned and synchronized through Git, so the board works offline and syncs when you run a sync command.
Is epiq free to use? What license does it have?
epiq is open source under the MIT license. Check the license terms before using it in commercial products.
Is epiq still maintained?
Actively maintained. The last commit to epiq was on Oct 21, 2026.
What can I use epiq for?
Tracking issues inside a code repository without a separate SaaS account. Reviewing what an AI agent did during an unattended work session. Working on issues offline and syncing changes later through Git. Linking code changes and their diffs directly to the tickets they address.
How do I install epiq?
Install the binary with the official install script from the README Or install via npm: npm install --global epiq Verify the installation: epiq --version Inside a Git repository, run Epiq to start the setup wizard: epiq
Where can I get epiq?
The source code and installation instructions are on GitHub: https://github.com/ljtn/epiq

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects