Skip to content

Fresh-eyes hygiene: fix dangling git-templates refs, stale docs#3

Open
fielding wants to merge 1 commit into
masterfrom
fable/fresh-eyes
Open

Fresh-eyes hygiene: fix dangling git-templates refs, stale docs#3
fielding wants to merge 1 commit into
masterfrom
fable/fresh-eyes

Conversation

@fielding

@fielding fielding commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Fresh-eyes hygiene pass. Conservative fixes only — no live shell/config behavior changes beyond silencing a git warning.

Fixes

Dangling init.templatedirgit/.gitconfig:42 and git/.gitconfig-add:51 still pointed at ~/.git-templates, removed from the repo back in 1e04c36 / 67dbb97. Every git init/git clone currently prints warning: templates not found in ~/.git-templates (verified). Removed the setting from both files, plus the matching stale .gitignore entry (git/.git-templates/hooks/*.sample). Note: the orphaned ~/.git-templates symlink in $HOME still exists on disk; a stow --restow git (or manual rm) after merging clears it.

Stale bootstrap.sh agent docs — the comment above DEFAULT_AGENTS referenced a pilot agent that has no plist and no agent_label_for mapping, while mouse-tap and holdpeek are real opt-in agents that were undocumented. Fixed the comment and the Available agents: info line to match agent_label_for + bootstrap/launchagents/.

README accuracy — the --agents paragraph now lists all three opt-in agents, and a short note documents the non-stow directories (bootstrap/, docs/, scripts/, holdpeek/, mouseless/) that previously appeared in neither the Active nor Legacy tables.

Verified

  • bash -n bootstrap.sh passes
  • both gitconfigs still parse (git config -f <file> --list)
  • security sweep of working tree + full history: no committed secrets (only the AWS docs example key in the old git-secrets config, and op:// 1Password references, which are pointers, not credentials)

Reported, not changed (uncertain / behavior-affecting)

  • git/.gitconfig-add is referenced nowhere in the repo — looks like a dead legacy variant of .gitconfig; candidate for deletion or a Legacy note.
  • [secrets] providers = git secrets --aws-provider remains in .gitconfig though the git-secrets hooks were removed — inert unless git-secrets is installed.
  • The tpm submodule (tmux/.tmux/plugins/tpm) is never initialized by bootstrap.sh; the deployed copy is a standalone clone, so a fresh machine gets no tmux plugins until tpm is installed manually. Worth a line in the shell phase if the fresh-machine claim should hold.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Xan5eRiAXvcnAVvXHejdTz

The .git-templates directory was removed from the git package
(1e04c36, 67dbb97), but both gitconfigs still set init.templatedir
to it, so every git init/clone warns "templates not found in
~/.git-templates". Drop the dangling setting and the matching stale
.gitignore entry.

Also sync the docs with what bootstrap.sh actually ships: the
"pilot" agent referenced in a comment has no plist or name mapping,
while mouse-tap and holdpeek exist as opt-in agents but were
undocumented. Note the non-stow source directories in the README.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xan5eRiAXvcnAVvXHejdTz
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