Help us shape the future of Go! Take the 2026 Go Developer Survey

tool

package
v0.1.0-alpha.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 27, 2026 License: MIT Imports: 13 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var ErrConflictingFilterFlags = errors.New("cannot specify both dirty_only and clean_only")

ErrConflictingFilterFlags is returned when both dirty_only and clean_only are set.

Functions

func RegisterDiff 

func RegisterDiff(server *mcpsdk.Server, cfg *config.Config)

RegisterDiff registers the git_iter_diff tool on the given MCP server.

func RegisterDo 

func RegisterDo(server *mcpsdk.Server, cfg *config.Config)

RegisterDo registers the git_iter_do tool on the given MCP server.

func RegisterGrep 

func RegisterGrep(server *mcpsdk.Server, cfg *config.Config)

RegisterGrep registers the git_iter_grep tool on the given MCP server.

func RegisterList 

func RegisterList(server *mcpsdk.Server, cfg *config.Config)

RegisterList registers the git_iter_list tool on the given MCP server.

func RegisterLsFiles 

func RegisterLsFiles(server *mcpsdk.Server, cfg *config.Config)

RegisterLsFiles registers the git_iter_ls_files tool on the given MCP server.

func RegisterStatus 

func RegisterStatus(server *mcpsdk.Server, cfg *config.Config)

RegisterStatus registers the git_iter_status tool on the given MCP server.

Types

type DiffToolInput 

type DiffToolInput struct {
	DiffFlags   []string `json:"diff_flags,omitempty" jsonschema:"arguments and flags passed to git diff"`
	Interactive bool     `json:"interactive,omitempty" jsonschema:"enable pager and interactive diff (default false)"`
	Patterns    []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot   string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	MaxProcs    int      `json:"max_procs,omitempty" jsonschema:"maximum parallel processes (default 1)"`
	Timeout     string   `json:"timeout,omitempty" jsonschema:"per-process execution timeout (e.g. 5s, 1m)"`
	Sort        bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit       int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	DirtyOnly   bool     `json:"dirty_only,omitempty" jsonschema:"only run in repositories with uncommitted changes"`
	CleanOnly   bool     `json:"clean_only,omitempty" jsonschema:"only run in repositories without uncommitted changes"`
	RemoteURL   string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

DiffToolInput defines parameters for git_iter_diff tool.

type DiffToolOutput 

type DiffToolOutput struct {
	Results []output.Result `json:"results" jsonschema:"git diff results per repository"`
}

DiffToolOutput defines output for git_iter_diff tool.

type DoToolInput 

type DoToolInput struct {
	Command     []string `json:"command" jsonschema:"command and arguments to execute in each repository"`
	Patterns    []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot   string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	MaxProcs    int      `json:"max_procs,omitempty" jsonschema:"maximum parallel processes (default 1)"`
	Timeout     string   `json:"timeout,omitempty" jsonschema:"per-process execution timeout (e.g. 5s, 1m)"`
	Sort        bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit       int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	RemoteURL   string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

DoToolInput defines parameters for git_iter_do tool.

type DoToolOutput 

type DoToolOutput struct {
	Results []output.Result `json:"results" jsonschema:"execution results per repository"`
}

DoToolOutput defines output for git_iter_do tool.

type GrepToolInput 

type GrepToolInput struct {
	GrepArgs    []string `json:"grep_args" jsonschema:"arguments passed to git grep (patterns, flags)"`
	Patterns    []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot   string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	AbsPath     bool     `json:"abs_path,omitempty" jsonschema:"show absolute paths instead of relative in grep results"`
	MaxProcs    int      `json:"max_procs,omitempty" jsonschema:"maximum parallel processes (default 1)"`
	Timeout     string   `json:"timeout,omitempty" jsonschema:"per-process execution timeout (e.g. 5s, 1m)"`
	Sort        bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit       int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	RemoteURL   string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

GrepToolInput defines parameters for git_iter_grep tool.

type GrepToolOutput 

type GrepToolOutput struct {
	Results []output.Result `json:"results" jsonschema:"grep results per repository"`
}

GrepToolOutput defines output for git_iter_grep tool.

type ListToolsInput 

type ListToolsInput struct {
	Patterns    []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot   string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	Sort        bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit       int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	RemoteURL   string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

ListToolsInput defines parameters for git_iter_list tool.

type ListToolsOutput 

type ListToolsOutput struct {
	Repositories []output.RepoResult `json:"repositories" jsonschema:"discovered repositories"`
}

ListToolsOutput defines output for git_iter_list tool.

type LsFilesToolInput 

type LsFilesToolInput struct {
	LsFilesFlags []string `json:"ls_files_flags,omitempty" jsonschema:"arguments passed to git ls-files"`
	Patterns     []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot    string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	AbsPath      bool     `json:"abs_path,omitempty" jsonschema:"show absolute paths instead of relative"`
	MaxProcs     int      `json:"max_procs,omitempty" jsonschema:"maximum parallel processes (default 1)"`
	Timeout      string   `json:"timeout,omitempty" jsonschema:"per-process execution timeout (e.g. 5s, 1m)"`
	Sort         bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse  bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit        int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	RemoteURL    string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

LsFilesToolInput defines parameters for git_iter_ls_files tool.

type LsFilesToolOutput 

type LsFilesToolOutput struct {
	Results []output.Result `json:"results" jsonschema:"matching files with prefixed paths"`
}

LsFilesToolOutput defines output for git_iter_ls_files tool.

type StatusToolInput 

type StatusToolInput struct {
	StatusFlags []string `json:"status_flags,omitempty" jsonschema:"arguments and flags passed to git status"`
	Patterns    []string `json:"patterns,omitempty" jsonschema:"repository path filter regular expressions"`
	ReposRoot   string   `json:"repos_root,omitempty" jsonschema:"root directory to scan for repositories"`
	MaxProcs    int      `json:"max_procs,omitempty" jsonschema:"maximum parallel processes (default 1)"`
	Timeout     string   `json:"timeout,omitempty" jsonschema:"per-process execution timeout (e.g. 5s, 1m)"`
	Sort        bool     `json:"sort,omitempty" jsonschema:"sort repository paths in ascending order"`
	SortReverse bool     `json:"sort_reverse,omitempty" jsonschema:"sort repository paths in descending order"`
	Limit       int      `json:"limit,omitempty" jsonschema:"limit number of processed repositories"`
	DirtyOnly   bool     `json:"dirty_only,omitempty" jsonschema:"only run in repositories with uncommitted changes"`
	CleanOnly   bool     `json:"clean_only,omitempty" jsonschema:"only run in repositories without uncommitted changes"`
	RemoteURL   string   `json:"remote_url,omitempty" jsonschema:"filter repositories by origin remote URL regex"`
}

StatusToolInput defines parameters for git_iter_status tool.

type StatusToolOutput 

type StatusToolOutput struct {
	Results []output.Result `json:"results" jsonschema:"git status results per repository"`
}

StatusToolOutput defines output for git_iter_status tool.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.