Git Hooks & Ignore Rules

Repo Nexus manages Git integration through the declarative git: block in rnex.yaml and .local.rnex.yaml.

---

Configuration Schema

git:
  ignore:
    - "repos/"
    - "**/.rnex*/"
    - "**/rnex*/"
    - "*.log"
    - ".env.local"
  hooks:
    post-merge:
      - "rnex sync --quiet"
    post-checkout:
      - "rnex sync --quiet"
    pre-commit:
      - "rnex plugin karpathy-llm lint"
    pre-push:
      - "rnex plugin karpathy-llm lint --strict"

---

Git Ignore Management (git.ignore)

During rnex init and rnex sync, Repo Nexus deterministically reconciles a dedicated # REPO-NEXUS:START ... # REPO-NEXUS:END section inside .gitignore while preserving any user-authored rules outside the markers:

1. Deterministic Recursive Patterns: Generated runtime assets are ignored recursively across all directories using trailing-slash directory patterns:

   • **/.rnex*/
   • **/rnex*/
   • <repos_dir>/ (default repos/)

   Trailing Slashes Protect Root Files

   Because the directory patterns explicitly end with /, Git matches only directories. The root CLI binary rnex and team configuration file rnex.yaml are never ignored by these patterns (while .local.rnex.yaml is ignored via its own explicit rule).

2. Synchronized Custom Patterns: All patterns defined in git.ignore (in both rnex.yaml and .local.rnex.yaml) are synchronized into the # REPO-NEXUS:START ... # REPO-NEXUS:END block in .gitignore. Adding, modifying, or removing entries in git.ignore updates the managed block on the next rnex sync.

3. Search Tool Un-Ignore (.ignore): Repo Nexus maintains .ignore (and .cursorignore, .geminiignore) with !<repos_dir>/* so search tools (ripgrep) and AI indexers can navigate member code without Git tracking.

---

Git Hooks Architecture (git.hooks)

Hook Wrappers (.git/hooks/*)

When git.hooks is configured, rnex sync installs lightweight executable POSIX shell wrappers in .git/hooks/ (e.g. .git/hooks/post-merge, .git/hooks/pre-commit).

Each wrapper:

1. Sources rnex configuration and libraries.
2. Reads the command list from git.hooks.<hook-name> (prioritizing .local.rnex.yaml over rnex.yaml).
3. Executes each command sequentially, failing fast if any command returns a non-zero exit code.
4. Chains to existing pre-existing Git hooks or scripts/githooks/ if present.

Two-Level Precedence

• Team Defaults: Configured in rnex.yaml.
• Workstation Overrides: Defined in .local.rnex.yaml. If .local.rnex.yaml contains git.hooks.<hook-name>, its command list takes precedence on that machine.