Genkit Git Tools

This Genkit plugin provides a set of tools for interacting with Git repositories. These tools allow Genkit flows to perform Git operations like checking the status of a repository, viewing diffs, and committing changes.

Installation

npm install genkitx-git

Usage

Here is an example of how to use the Git tools in a Genkit flow:

import { genkit, z } from 'genkit';
import { googleAI } from '@genkit-ai/googleai';
import { defineGitTools } from 'genkitx-git';

const ai = genkit({
  plugins: [googleAI()],
  model: googleAI.model('gemini-2.5-flash'),
});

const gitTools = defineGitTools(ai);

ai.defineFlow(
  {
    name: 'query',
    inputSchema: z
      .string()
      .default('what are the pending changes in my current directory: ' + process.cwd()),
  },
  async (prompt) => {
    const { text } = await ai.generate({
      prompt,
      tools: [...gitTools],
    });
    return text;
  }
);

This flow takes a natural language prompt and uses the Git tools to answer questions about the state of a Git repository.

Available Tools

This plugin provides the following tools:

• git_add
• git_addAnnotatedTag
• git_addConfig
• git_addRemote
• git_addTag
• git_branch
• git_branchLocal
• git_checkIgnore
• git_checkout
• git_checkoutBranch
• git_checkoutLocalBranch
• git_clone
• git_commit
• git_deleteLocalBranch
• git_deleteLocalBranches
• git_diff
• git_fetch
• git_getConfig
• git_getRemotes
• git_init
• git_listConfig
• git_listRemote
• git_log
• git_merge
• git_pull
• git_push
• git_pushTags
• git_rebase
• git_remote
• git_removeRemote
• git_reset
• git_revert
• git_show
• git_stash
• git_stashList
• git_status
• git_tag
• git_tags

MCP Server

You can run genkitx-git as an MCP server (stdio) using the following command:

npx -y genkitx-git

Learn more about Genkit on https://genkit.dev

Get started with Genkit: https://genkit.dev/docs/get-started/