Skip to content

Audit home directory for unmanaged dotfiles and bring them under chezmoi #28

Description

@nickvigilante

Background

PR #27 discovered that ~/.claude/CLAUDE.md and ~/.claude/RTK.md were live-only files —
not under chezmoi management, so they never reproduced across machines.
They were brought in as part of that PR, but the discovery was incidental.
There are almost certainly other config files in the same state.

Task

Comprehensively scan the home directory on each machine/repo for dotfiles that
should be chezmoi-managed but currently aren't, and bring the relevant ones
under management so they reproduce everywhere.

Suggested approach

  1. Enumerate candidate config locations — ~, ~/.claude, ~/.config,
    ~/.zshrc and related shell files, ~/.gitconfig, ~/.ssh/config, editor configs, etc.
  2. For each candidate, check management status with chezmoi managed / chezmoi source-path <file>.
  3. Triage the unmanaged hits: which are genuinely portable config worth tracking,
    versus machine-local, secret, or generated files that should stay out (or be templated/ignored).
  4. chezmoi add the keepers (use private_/templating where appropriate), then verify with chezmoi diff.
  5. For anything intentionally excluded, record it in .chezmoiignore so the decision is explicit.

Acceptance criteria

  • A documented list of unmanaged dotfiles found, each marked track / ignore / secret with a reason.
  • All "track" files added to the chezmoi source and landed via PR.
  • chezmoi diff is clean (no unexpected drift) after the additions.
  • Run the audit per machine, since live-only drift is machine-specific.

Conventions

  • No unique machine identifiers in any PR (title, body, branch name, or commit messages).
    Live-only drift is machine-specific, but the published artifacts must stay opaque about which
    machine — refer to "one machine" / "this machine" and the audit sequence number only.
    Never include hostnames or other uniquely identifying details.

Audit progress

Drift is machine-specific, so the audit runs once per machine; the six can be done in any order.

🤖 Built with AI assistance.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions