Skip to content

doc: explain rules discovery from project directories - #439

Open
ryantm wants to merge 1 commit into
fix/issue4-terminal-restorefrom
doc/issue201-project-rules
Open

ryantm wants to merge 1 commit into
fix/issue4-terminal-restorefrom
doc/issue201-project-rules

Conversation

@ryantm

@ryantm ryantm commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Document how to run agenix from a project root or descendant directory using parent discovery of agenix-rules.nix. Include a root bridge that prefixes keys from a nested rules file, plus an explicit AGENIX_RULES example using Git to locate the project root.

The guide states the filename base, nearest-file precedence, legacy-name behavior, and the absence of recursive descendant discovery so users can select the intended rules deterministically.

Validation: exercised the documented bridge with the real CLI, editing from the root and a nested directory, decrypting, rekeying one file, checking recipients, and selecting the nested rules explicitly. The documentation build passed. Based on #429.

Closes #201.

Related to #23: parent-directory rules discovery addresses one of the original CLI concerns while retaining Nix rules. Replacing the CLI language or configuration schema remains a separate maintainer decision.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant