Method Execute

tools/builtin.go:591–661

(ctx context.Context, execCtx ExecutionContext, input any)

}

func (t *GrepSearchTool) Execute(ctx context.Context, execCtx ExecutionContext, input any) (string, error) {
	if _, err := exec.LookPath("rg"); err != nil {
		return "Error: ripgrep (rg) is not installed. Please install it from https://github.com/BurntSushi/ripgrep", nil
	}
	in := deref[GrepSearchInput](input)
	if in.Path == "" {
		in.Path = "."
	}
	if in.OutputMode == "" {
		in.OutputMode = "files_with_matches"
	}
	headLimit := 250
	if in.HeadLimit != nil {
		headLimit = *in.HeadLimit
	}
	searchPath := resolveToolPath(execCtx, in.Path)
	cwd := stringFromExecCtx(execCtx, "cwd")
	if cwd == "" {
		cwd = config.GetConfig().CWD
	}
	args := []string{"--no-heading", "--with-filename", "--line-number", "--color=never"}
	if in.CaseInsensitive {
		args = append(args, "-i")
	}
	if in.Glob != "" {
		args = append(args, "--glob", in.Glob)
	}
	switch in.OutputMode {
	case "files_with_matches":
		args = append(args, "-l")
	case "count":
		args = append(args, "-c")
	}
	args = append(args, in.Pattern, searchPath)
	cmdCtx, cancel := context.WithTimeout(ctx, 10*time.Second)
	defer cancel()
	cmd := exec.CommandContext(cmdCtx, "rg", args...)
	cmd.Dir = cwd
	var stdout, stderr bytes.Buffer
	cmd.Stdout = &stdout
	cmd.Stderr = &stderr
	err := cmd.Run()
	if cmdCtx.Err() == context.DeadlineExceeded {
		return "Error: grep search timed out (10s limit). Try narrowing the search scope.", nil
	}
	if err != nil && stdout.Len() == 0 {
		// rg returns 1 for no matches; Python treats empty stdout as no matches.
		if stdout.Len() == 0 {
			return "No matches found.", nil
		}
	}
	output := strings.TrimSpace(strings.ToValidUTF8(stdout.String(), "\uFFFD"))
	if output == "" {
		return "No matches found.", nil
	}
	lines := strings.Split(output, "\n")
	if headLimit != 0 && len(lines) > headLimit {
		keep := headLimit