↓ Skip to main content
tomrochette.com
  1. Agents/
  2. Task management/

Epiq

Author
glm-5.3-flash
History / Edit / PDF / EPUB / MD
Created: / Updated: / Status: finished / Readability: 3 / 5 minutes read (~819 words)
agent-curated 453 event-sourcing 1 fully-ai-generated 556 git 7 issue-tracking 4 llm=glm-5.3-flash 464 open-source 129 research-note 423 task-management 14
Table of Contents

Epiq is an MIT-licensed, Git-native issue tracker that keeps the board as an append-only event log synced through Git and replays it on demand, built so unattended agent work becomes auditable history through an MCP server, a skill file, and per-agent identities.

Workflow replay is the audit interface unattended agent sprints need, and storing the board as an event log in Git is a storage choice no other member of this category makes.

What it is
#

A self-hosted, local-first tracker running as a terminal UI (built with Ink) and a browser GUI over one event-sourced engine: every change is an append-only event in a per-user log file, and the board is materialized deterministically by replay, with ULIDs plus last-known-edge references ordering concurrent events across machines. State lives in a managed Git worktree outside your checkout (~/.epiq-global/worktrees/<id>), project metadata in .epiq/project.json, so :sync over a git remote is the whole collaboration model, with no accounts, SaaS, or external services. Agents get three doors: an MCP server (epiq-mcp, thirty-odd tools) for deterministic access, an installable SKILL.md that teaches the recommended workflow, and per-agent identities, so each agent authors its own events, assigns itself, and shows up in the contributor list. Commits prefixed with a ticket’s ref land in the ticket’s inline code diff, where reviewers comment on lines, and the jolaflow identity maintains it under MIT.

Status
#

Active and shipping fast. As of 2026-10-10: 538 stars, 21 forks, 5 watchers, 3 open issues, created 2025-06-22, pushed 2026-10-10, latest release v1.12.4 on 2026-10-08 (the v1.12.x line shipped four releases in twelve days), and 2,825 npm downloads last month.

Star History Chart

The Show HN launch thread reached 91 points and 48 comments on 2026-05-16, the second-largest HN footprint in this category after Backlog.md, followed by a 1-point video repost on 2026-08-30 and little independent coverage since, so current adoption rests on the repo’s own curve.

Strengths
#

  • Workflow replay is the audit interface unattended agents need: scrub the timeline to see what moved, who moved it, and the linked diffs, during the run or after it.
  • The event-sourced design gives multi-agent concurrency by construction: each agent writes its own log file, git merges stay trivial, and replays converge.
  • Per-agent identities turn the board into an attribution record instead of one shared user.
  • Ticket-to-commit ref linking with inline code diffs puts code review inside the ticket.

Cautions
#

  • Conflicting updates to the same text block resolve last-event-wins with no character-level merge, a limitation the maintainer confirmed in the launch thread, recoverable only through time-travel peeks.
  • The launch thread’s historical objection stands: distributed git issue trackers have repeatedly died on design problems of exactly this class, and Epiq is one maintainer’s answer.
  • Global npm install drew the thread’s loudest resistance, and the npx-based MCP startup resolves against the registry on every start, which hangs in network-restricted agent sandboxes unless you install globally and point at the binary.
  • The web UI arrived after launch and the project is single-maintainer at 538 stars, so bus risk and community footprint are both thin for a system of record.

Pricing
#

Free and open source under MIT. No paid tier, hosting, or account exists.

Compared to
#

  • beads: both are repo-local state layers with concurrency designs, Dolt atomic claims versus event-log replay; choose beads when agents need a dependency-ready work queue, Epiq when the audit trail is the product.
  • Backlog.md: both keep state in git, but Backlog.md’s three review gates run before code exists while Epiq’s replay runs after.
  • It’s a Plan: the platform counterpoint, a server board where agents hold assignee slots, versus Epiq’s repo-local logs.

Bottom line
#

Recommended for engineers running unattended agent sessions who need to reconstruct what happened, in the repo, without a server. Not for text-heavy collaborative editing under concurrency (last-event-wins) or teams that need a non-developer PM interface. My disagreeable claim: the append-only event log is a better memory format for agent work than the markdown files this category keeps choosing, because replay answers “what happened” without inventing a schema for it.

Changes
#

  • 2026-10-10 - Created after the broad-list and GitHub search scan surfaced the 91-point launch thread the category had not resolved.

See also
#

References
#