Use when a hand-edit to a global, machine-level agent config should become permanent everywhere — the user edited ~/.claude/settings.json, ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, ~/.cursor/, ~/.gemini/ or ~/.config/opencode/ by hand and says 'make this permanent', 'save this to the repo', 'keep this setting', 'add this rule everywhere', 'sync my machine back to the repo', 'capture my config', 'I tweaked a permission, don't lose it', 'put this on all my platforms' — or setup/doctor reports the machine has drifted from the repo and the machine is right. Offer it proactively right after helping the user hand-edit one of those files.