Ghillie can render repository status reports as Markdown documents and write them to the filesystem at predictable paths, making reports navigable by operators and version-controllable.
Enabling filesystem report storage
Set the GHILLIE_REPORT_SINK_PATH environment variable to a directory path.
When configured, each report generation run writes two files per repository:
{base_path}/{owner}/{name}/latest.md— always overwritten with the most recent report.{base_path}/{owner}/{name}/{date}-{report_id}.md— a dated archive that accumulates over time.
export GHILLIE_REPORT_SINK_PATH=/var/lib/ghillie/reports
When the variable is unset, report generation works as before without writing any Markdown files.
Markdown format
The rendered Markdown document follows this structure:
```markdown
acme/widget — Status report (2024-07-07 to 2024-07-14)
Status: On Track