gitlore

gitlore

A Claude Code plugin that makes Claude's auto-memory versioned, shared, and git-backed. See docs/design.md for the design and docs/plans/ for implementation plans.

Install

Add the marketplace, install the plugin, then run the per-repo setup:

/plugin marketplace add ddaanet/claude-plugins
/plugin install gitlore@ddaanet

Then, in your project repo with Claude Code running:

/gitlore:install

You'll be asked for a memory subpath (default memory) and your project's pre-commit command (e.g. lefthook run pre-commit). A memory remote is created only if the parent repo has a remote, and that step uses gh when available.

After /gitlore:install, the launcher in .gitlore/bin/claude is activated automatically: direnv is approved if available, otherwise a global shim is installed under ~/.gitlore/bin/ and install prints the one-line PATH addition to add to your shell rc. Either way, Claude Code's auto-memory redirects into the submodule on the next session.

Development

make test       # runs the bats suite

Dependencies:

• bash ≥ 3.2
• git ≥ 2.13 (for git submodule absorbgitdirs; install also uses manual gitdir absorption that works on older versions)
• jq
• bats-core ≥ 1.10 (brew install bats-core or npm i -g bats)
• mikefarah/yq v4 OR python3 with PyYAML — required for wire-lefthook.sh and wire-overcommit.sh to safely merge user YAML configs without clobbering existing keys. Note: yq-based wiring will strip pre-existing YAML comments from lefthook.yml / .overcommit.yml (the gitlore marker is preserved, user comments are not).

Status

Feature-complete: all functional requirements and design decisions (D1–D16) in docs/design.md are implemented and tested.

• Plan 01 — local memory pipeline ✅
• Plan 02 — remote and push ✅
• Plan 03 — semantic merge / resolve ✅
• Plan 04 — marketplace install ✅ (push + marketplace entry + outer-loop dogfood)
• Plan 05 — memory redirect launcher ✅ (shim + Placement A direnv + Placement B global + SessionStart guard)
• Plan 07 — gitlink-aware wrappers / worktree lifecycle (D11) ✅ (common-dir-anchored hook wrappers; SessionStart creates the memory worktree in linked worktrees; advisory WorktreeRemove teardown)
• Dogfood-driven hardening (D12–D16) ✅ (submodule-side commit gate; git lock-contention retry; SessionStart output on systemMessage; in-process-worktree memory-drift guard; standalone memory-commit entry point; SessionStart disclosure trimmed to prohibition + seamless happy path)