Introduction
edhil
edhil is a command line tool that takes the epics and work items of a project on GitLab or Forgejo, has a coding agent implement them one by one, verifies each change with the commands that the work item names, commits it with a validated message and keeps a journal of everything it did.
The coding agent is the tool you already use: GitHub Copilot, Claude Code, Codex or opencode. You choose it, and the model it uses, in your configuration or with --agent on the command line.
This book describes how to install and configure it, how it works, every command, and how to use it as part of a stage-gated way of working where an epic is designed, refined into work items, imported into the forge and implemented.
The commands are:
edhil import file.md import a markdown epic into the forge
edhil implement 123 implement an epic or a work item
edhil log list the logs of the runs
edhil log 12 show the log of run 12
edhil work-items list the open epics and work items
edhil commit commit the current changes with a drafted message