non-tech-git-assistant

Read this in 正體中文.

A Claude Code plugin marketplace for people who aren't comfortable with git.

Its plugin, git-helper, is a beginner-friendly git assistant that acts on your behalf: you describe what you want in plain, everyday language, and it runs the right git commands for you — explaining each step and never doing anything risky without asking first. It replies in your language.

What it does

• Everyday save & upload — "save my work", "upload to GitHub" → handles commit, push, pull for you.
• Undo & recover (the regret pill) — wrong commit message, deleted file, want to go back → prefers safe, recoverable fixes.
• Branches & merging — create/switch branches, merge, and walk through merge conflicts step by step.
• Remote & GitHub — clone, connect a remote, sync, and understand Pull Requests.
• Safety guardrails — before anything destructive (e.g. reset --hard, discarding changes), it explains the consequence, offers a safer alternative, and asks for your confirmation first. It will never force-push on your behalf.

Install

/plugin marketplace add milkmidi/non-tech-git-assistant
/plugin install git-helper@non-tech-git-assistant

For local development (test edits without pushing first), point the marketplace at your local copy instead:

/plugin marketplace add <local-path-to-this-repo>
/plugin install git-helper@non-tech-git-assistant

To update after changes: /plugin uninstall git-helper@non-tech-git-assistant then install again. (For the local copy, reopening a session usually picks up edits.)

Verify it works

1. Installed? Run /plugin and confirm git-helper is in the Installed list.

2. Skill loaded? Skills load at the start of a conversation, so open a new session before testing triggers.

3. Behaves correctly? In a real git project folder, type these and check the responses:

   You type	What you should see
   save my work	runs git status → if on main/master, offers a branch first → proposes a commit message for you to confirm
   I deleted the wrong file	reassures first → recovers with a safe restore/stash, never a destructive delete
   help me force push	refuses to run it → steers you to pull then a normal push

   If those three behave as described, the skill is installed and triggering correctly.

How to use

Once installed, just talk to Claude in plain language. Examples:

• "help me save my work"
• "I deleted the wrong file"
• "how do I upload this to GitHub?"
• "what's a branch and how do I make one?"

The assistant replies in your own language and walks you through one step at a time.

Sample conversation

You: save my work

Assistant: Let me check what you changed first… (runs git status) You changed 2 files: index.html, style.css. Suggested save note: "Update homepage layout and styles" — sound good, or would you like to write your own?

You: sounds good

Assistant: Done, saved ✅ (git add -A + git commit). This is a save point on your computer — it hasn't been uploaded to GitHub yet. Want me to upload it as a backup?

---

You: oh no, I deleted a file

Assistant: Don't worry — this is usually recoverable 🙂 Let me check the situation… (runs git status) The deleted file is notes.txt, and the deletion isn't saved yet. I can bring it straight back with git restore notes.txt — that's a safe action. Want me to do it?

You: yes

Assistant: Recovered ✅ notes.txt is back to its original contents.

---

You: help me force push

Assistant: I won't run a force push for you ⚠️ — it overwrites what's on GitHub with your local version and can permanently erase a teammate's work, with no way to recover it. The safe way to get your changes up is usually: git pull first to bring in anything you're missing, then a normal git push. Want me to do that instead? (If a force push truly is the only option, that's an advanced, risky step — best done with someone experienced.)

License

MIT