Function glob

src/utils/glob.ts:253–342

(
  filePattern: string,
  cwd: string,
  { limit, offset }: { limit: number; offset: number },
  abortSignal: AbortSignal,
  toolPermissionContext: ToolPermissionContext,
)

}

export async function glob(
  filePattern: string,
  cwd: string,
  { limit, offset }: { limit: number; offset: number },
  abortSignal: AbortSignal,
  toolPermissionContext: ToolPermissionContext,
): Promise<{ files: string[]; truncated: boolean }> {
  let searchDir = cwd
  let searchPattern = filePattern

  // Narrow the search root for both absolute and relative patterns.
  // ripgrep's --glob flag only matches paths relative to the search dir.
  const { baseDir, relativePattern } = extractGlobBaseDirectory(filePattern)
  if (baseDir) {
    searchDir = isAbsolute(baseDir) ? baseDir : join(cwd, baseDir)
    searchPattern = relativePattern
  } else if (isAbsolute(filePattern)) {
    searchDir = dirname(filePattern)
    searchPattern = basename(filePattern)
  }

  const ignorePatterns = normalizePatternsToPath(
    getFileReadIgnorePatterns(toolPermissionContext),
    searchDir,
  )
  const pluginExclusions = await getGlobExclusionsForPluginCache(searchDir)

  let allPaths: string[]
  if (
    isDirectoryGlobPattern(filePattern) ||
    (await isExactDirectoryPattern(searchPattern, searchDir))
  ) {
    allPaths = await globDirectories(
      searchPattern.endsWith('/') ? searchPattern : `${searchPattern}/`,
      searchDir,
      [...ignorePatterns, ...pluginExclusions],
      abortSignal,
    )
  } else {
    if (isRecursiveLiteralDirectoryNamePattern(searchPattern)) {
      const directoryMatches = await globDirectories(
        `${searchPattern}/`,
        searchDir,
        [...ignorePatterns, ...pluginExclusions],
        abortSignal,
      )
      if (directoryMatches.length > 0) {
        const truncated = directoryMatches.length > offset + limit
        const files = directoryMatches.slice(offset, offset + limit)
        return { files, truncated }
      }
    }

    // Use ripgrep for better memory performance
    // --files: list files instead of searching content
    // --sort=modified: sort by modification time (oldest first)
    // --no-ignore: don't respect .gitignore (default false; set CLAUDE_CODE_GLOB_NO_IGNORE=true to include ignored files)
    // --hidden: include hidden files (default true, set CLAUDE_CODE_GLOB_HIDDEN=false to exclude)