Skip to main content
Glama

GitKit

简体中文 · Releases · Issues · MIT

A Git CLI for people and a stdio MCP server for agents. Both share one TypeScript engine for inspecting, committing, pulling and pushing changes. GitHub and Gitee also support creating and updating same-repository and cross-fork pull requests.

Install

Requires Node.js 22+ and Git 2.39+. Install Git LFS for large-file workflows.

npm install -g https://github.com/IweirdoI/gitkit/releases/download/v0.1.4/gitkit-agent-0.1.4.tgz
gitkit --help

The npm package name is gitkit-agent. Once the version is available on npm, run npx gitkit-agent@0.1.4 --help or install it with npm install -g gitkit-agent@0.1.4. Check npm availability.

Related MCP server: diff-sentinel

Use it in a repository

gitkit status --json
gitkit diff staged
gitkit commit --paths src --dry-run
gitkit pull --ff-only
gitkit push --pr --base main --dry-run

Run from your repository or pass --cwd <repository>. Each command has --help. Remove --dry-run when you are ready to execute. Git uses your configured HTTPS credential helper or SSH agent. PR operations read GITHUB_TOKEN or GH_TOKEN on GitHub, or GITEE_TOKEN on Gitee.

Set up an agent

Send this repository URL and the following prompt to an agent with terminal and MCP configuration access.

Read README.md and docs/agents.en.md here. Install the pinned GitKit version using the documented command, register its stdio MCP server for my current Git repository, and verify it with the read-only status tool. Follow my client's approval rules.

Codex, Claude Code/Desktop, Cursor and DeepSeek Harness support stdio. DeepSeek Harness also has a native plugin. ChatGPT custom apps can connect through a Secure MCP Tunnel where available. Client-specific setup and upgrade instructions.

Fork pull requests and connectivity

gitkit push --pr --base main --base-repo upstream/project pushes to the selected remote and opens or updates a PR in the explicit target repository. This avoids using an outdated fork default branch as the PR base.

If the branch has already been uploaded, use gitkit push --pr --pr-only --base main --base-repo upstream/project. GitKit verifies through the platform API that the remote source branch equals local HEAD before synchronizing the PR. This mode needs a platform token. It performs PR API operations without Git transfer.

Read-only remote discovery retries a network error or timeout once, then reports the error. Each attempt uses the configured subprocess timeout. Writes and hooks are not automatically replayed. API object uploading is outside this release.

Uninstall

Remove the MCP entry from the client, then uninstall the CLI. For Codex:

codex mcp remove gitkit
npm uninstall -g gitkit-agent

For the DeepSeek Harness native plugin, use dsh plugin --profile web remove gitkit-agent with your profile name. Removal by client.

Benchmark

The 0.1.3 commit response includes the actual stored subject, including hook changes, so agents can report it without another log call. A fresh 12-pair comparison against native Git found 35.38% fewer total tokens and 16.02% lower mean end-to-end time across four tasks. Commit alone used 55.92% fewer total tokens and 37.86% less time. Full results and limits.

Average time and token usage for GitKit and native Git

GitKit 0.1.1 averaged 6.28 s faster (20.87%) and 35,933 fewer total tokens (33.14%) per task in 12 paired GPT-6.1-Sol trials on Windows. Both groups passed 12/12 repository checks. GitKit was faster in 11 pairs and used fewer total tokens in all 12. Uncached input fell 17.90% overall. Pull and push used local bare remotes. Method and reproduction · Sanitized measurements.

Contribute

Run npm ci, npm test, and npm pack from a clone. Source lives in src/, tests in test/, and experiments in bench/. Contributing · Recovery · Git attributes template · Private security reporting.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      Enables MCP clients to inspect and modify local git repositories by running commands such as status, log, diff, add, commit, branch, and stash. Push operations are not performed locally; instead diffs are sent to a configurable HTTP API that handles the upload, with all other remote git commands blocked.
      27
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to audit git diffs, scan for leaked secrets and unsafe APIs, detect breaking changes, triage issues, generate changelogs, and assess repository hygiene through native stdio JSON-RPC tools.
      7
      Apache 2.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables compatible AI clients to open, inspect, edit, test, commit, and manage GitHub repositories through local STDIO or authenticated remote Streamable HTTP, including issues, pull requests, workflows, and repository creation.
      30
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables an AI agent to perform real GitHub operations such as creating repositories, opening and closing issues, commenting, listing commits, and committing file changes through natural language via the Model Context Protocol over stdio.
      8
      MIT