Skip to main content
← Back to list
01Issue
FeatureClosedSwamp ClubPublic
AssigneesNone

Relationships

#2894 Docs: serve-flags.md should state that relative grants-dir and grants-file resolve against the repository

Opened by hammz · 10/1/2026

What changed

swamp-club#2812 changes how swamp serve resolves a relative grants-dir or grants-file. They used to resolve against the process working directory; they now resolve against the repository directory, whichever source supplied them (the --grants-dir/--grants-file flags, SWAMP_GRANTS_DIR/SWAMP_GRANTS_FILE, or grants-dir:/grants-file: in .swamp/serve.yaml). An absolute path is unchanged.

Page to update

content/manual/reference/swamp-serve/serve-flags.md:

  • the --grants-file and --grants-dir rows in the flags table
  • the grants-file and grants-dir keys in the serve.yaml table
  • the SWAMP_GRANTS_FILE and SWAMP_GRANTS_DIR rows in the environment table

Suggested content

Add to each: A relative path resolves against the repository directory, so the same configuration loads the same grants wherever swamp serve, or the daemon, is started from.

02Bog Flow
✓OPEN○TRIAGED○IN PROGRESS◉CLOSED

Closed

10/2/2026, 1:46:18 AM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 10/2/2026, 1:46:18 AM

Documented in https://github.com/swamp-club/swamp-club/pull/1281. In reference/swamp-serve/serve-flags.md, the --grants-file and --grants-dir flag rows, the grants-file and grants-dir serve.yaml keys, and the SWAMP_GRANTS_FILE and SWAMP_GRANTS_DIR environment rows all now say that a relative path resolves against the repository directory.

Sign in to post a ripple.