Giteasy

Name: Giteasy
Author: greenmtnsun

@greenmtnsun

About Giteasy

When your AI runs git through a shell, it reads back raw command output — hundreds of tokens of noise to extract one piece of information. GitEasy MCP returns structured data: branch names, changed files, commit history — exactly what your AI needs, nothing extra. The same git op

#git-version-control-developer-tools-powershell-mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "giteasy": {
      "type": "http",
      "url": "https://giteasy-mcp.azurewebsites.net/mcp",
      "headers": {
        "X-Api-Key": "ge_your_key_here"
      }
    }
  }
}

Tools

Send already-committed work to the remote without making a new commit. Pushes the current branch; on a branch's first push, sets the remote branch as its upstream automatically.

Show git repository diagnostic info: current branch, upstream, HEAD SHA, remote URLs, and status summary.

Configure the git credential helper to use a specific vault path. Returns new credential helper value.

Restore a single file to its HEAD state, discarding uncommitted changes. Returns restored file path.

Clear stored git credentials by unsetting the credential helper in local git config. Returns confirmation.

Change a remote URL to its SSH equivalent. Returns old and new remote URLs.

Stage changes, commit with a message, and optionally push to remote. Returns commit SHA and push result.

Report current git credential helper configuration. Returns helper name and scope.

Test whether git credentials are working by attempting ls-remote against the origin. Returns success/failure and remote refs count.

List all tags/releases in the repository, newest first. Returns tag names, target SHAs, and annotation messages.

Show the diff for a specific file or all changed files. Returns unified diff text.

Create an annotated git tag and push it to the remote. Returns the tag name and target commit SHA.

List changed files: staged, unstaged, and untracked. Returns file counts and paths by status group.

Show all remote names and their fetch/push URLs. Returns list of remotes with URL and type.

Fetch from remote and show incoming commits not yet in local branch. Returns count and commit summaries.

Discard uncommitted changes. If filePath given, restores that file; otherwise restores all tracked files. Returns list of restored paths.

Switch to an existing branch. Returns the branch switched to and current HEAD SHA.

Search commit history for commits whose message matches a search term. Returns matching commits with SHA, author, date, and message.

Show recent commit history. Returns commits with SHA, author, date, and message.

Create a new branch from current HEAD and switch to it. Returns branch name and base commit SHA.

Store a personal access token for HTTP git authentication. Returns confirmation (token value is never echoed).

Remove untracked files and directories from the working tree (git clean -fd). Returns list of removed paths.

Overview

What is Giteasy?

Giteasy is a PowerShell module that provides a plain-English command set for saving and publishing work in Git repositories, designed for users who are not familiar with Git jargon. It acts as a frictionless wrapper over Git, hiding complex commands and showing only simple prompts, log files, and clear error messages. It is built by Keith Ramsey for non-developers such as DBAs, compliance teams, and change managers who need to use Git without learning a new vocabulary.

How to use Giteasy?

Install by cloning the repository into the user-scope PowerShell module folder and running Import-Module GitEasy. Alternatively, once published to the PowerShell Gallery, use Install-Module GitEasy -Scope CurrentUser. Then, in any Git repository, run commands like Find-CodeChange, Save-Work 'message', Show-History, and Show-Remote. Each command has full comment-based help accessible via Get-Help <Command> -Full.

Key features of Giteasy

Plain-English commands that replace raw Git syntax
No raw Git output ever shown to the user
Every action writes a self-contained diagnostic log file
21 public commands covering save, history, branching, and credential management
Works with existing Git repositories and credential helpers

Use cases of Giteasy

Non-developers saving and publishing work without learning Git jargon
Isolated task management using New-WorkBranch and Switch-Work
CI/CD pipelines or AI agents via dedicated documentation (docs/USING-IN-CI-AND-AGENTS.md)
Quick diagnostics and file restoration with Restore-File and Undo-Changes

FAQ from Giteasy

What does Giteasy do that raw Git does not?

Giteasy hides all Git jargon and technical output, showing only plain-English messages and log file paths. It simplifies common workflows into a handful of commands (e.g., Save-Work stages, commits, and pushes in one step) and never displays raw Git error text.

What are the system requirements?

Windows PowerShell 5.1 or PowerShell 7+ (Windows only; cross-platform may work but is not the design target). Git must be installed and available on PATH.

How are credentials handled?

Giteasy supports HTTPS login via Set-Token, SSH login via Set-Ssh, and credential storage via Set-Vault. Use Get-VaultStatus to see the configured credential helper, and Reset-Login to forget saved credentials.

Does Giteasy support CI/CD pipelines or AI agents?

Yes. A dedicated page (docs/USING-IN-CI-AND-AGENTS.md) provides a one-page contract for consumers running Giteasy from CI jobs or AI coding agents.

Is Giteasy accepting contributions?

No. The project is maintained by a single author and is not currently accepting outside pull requests (no contributor license agreement in place). Bug reports and feature suggestions as GitHub Issues are welcome.