[BUG] /agents 命令无法获取项目级 agents

[sobird]

描述错误

在终端输入框中，输入 /agents 命名，回车后无法获取项目级 agents 列表，另外猜测，输入框中输入 @ 引用文件 属于同一类似问题（本地文件搜索功能失效）

重现步骤

cd 本仓库目录
bun run dev

或者
bun run build
npm link

cd 自己的项目
# 为避免与原claude命令冲突，已将 claude 命令重命名为 sobird
sobird

• 输入 /agents 回车，无法列出项目级 agents （位于 .claude/agents/*.md）
• 同样的输入 @ 使用tab键快速搜索并引用项目文件无法使用

预期行为

输入 /agents 回车后，可以看到已存在的项目级 agents
输入 @ 使用tab键 可快速搜索并引用项目文件

---

Bug Description

When entering the /agents command in the terminal input box and pressing Enter, the project-level agents list fails to load. Additionally, I suspect this is related to a broader issue where the @ symbol for file referencing is also broken (local file search functionality is unresponsive).

Steps to Reproduce

cd /path/to/this/repo
bun run dev

# OR
bun run build
npm link

cd /path/to/your/project
# Renamed 'claude' to 'sobird' to avoid conflicts with the original command
sobird

• Type /agents and press Enter: Fails to list project-level agents (located in .claude/agents/*.md).
• Type @ and attempt to use the Tab key to quickly search and reference project files: Functionality is unavailable.

Expected Behavior

• For /agents: Pressing Enter should display a list of all existing project-level agents.
• For @: Pressing the Tab key should trigger a quick search and allow for referencing local project files.

[sobird]

请帮我分析 项目中的 /agents 命令，为什么不能列出项目级 .claude/agents/*.md 的agents

问题分析

您遇到的 agents 命令无法列出 .claude/agents/*.md 文件的问题，根本原因是 Bun 运行时环境下的 ripgrep 兼容性 (缺失)问题。

具体原因

1. /agents 命令通过 loadMarkdownFilesForSubdir('agents', cwd) 函数来查找代理配置文件
2. 这个函数使用 ripgrep 工具在 .claude/agents/ 目录中搜索 markdown 文件
3. 在当前 Bun 环境中，ripgrep 的底层 execFile 调用失败了，因为它期望接收字符串参数但收到了数组（与 Node.js 的行为不同）
4. 这导致文件搜索静默失败，返回 0 个文件而不是预期的代理定义

证据确认

• .claude/agents/frontend-expert.md 文件确实存在且可读
• 路径解析功能正常 (getProjectDirsUpToHome 能找到正确目录)
• 手动在终端运行 ripgrep 命令是成功的
• 问题是特定于这个 Bun 环境中的 ripgrep 集成

claude-code/src/utils/ripgrep.ts

Lines 31 to 65 in a4b4291

	const getRipgrepConfig = memoize((): RipgrepConfig => {
	const userWantsSystemRipgrep = isEnvDefinedFalsy(
	process.env.USE_BUILTIN_RIPGREP,
	)
	// Try system ripgrep if user wants it
	if (userWantsSystemRipgrep) {
	const { cmd: systemPath } = findExecutable('rg', [])
	if (systemPath !== 'rg') {
	// SECURITY: Use command name 'rg' instead of systemPath to prevent PATH hijacking
	// If we used systemPath, a malicious ./rg.exe in current directory could be executed
	// Using just 'rg' lets the OS resolve it safely with NoDefaultCurrentDirectoryInExePath protection
	return { mode: 'system', command: 'rg', args: [] }
	}
	}
	// In bundled (native) mode, ripgrep is statically compiled into bun-internal
	// and dispatches based on argv[0]. We spawn ourselves with argv0='rg'.
	if (isInBundledMode()) {
	return {
	mode: 'embedded',
	command: process.execPath,
	args: ['--no-config'],
	argv0: 'rg',
	}
	}
	const rgRoot = path.resolve(__dirname, 'vendor', 'ripgrep')
	const command =
	process.platform === 'win32'
	? path.resolve(rgRoot, `${process.arch}-win32`, 'rg.exe')
	: path.resolve(rgRoot, `${process.arch}-${process.platform}`, 'rg')
	return { mode: 'builtin', command, args: [] }
	})

解决方案

方案一：临时使用原生文件搜索（快速修复）

export CLAUDE_CODE_USE_NATIVE_FILE_SEARCH=true

方案二：正确安装 ripgrep
确保您的环境中有可用的 ripgrep 工具，这样现有的代码就能正常工作。

方案三：项目中添加 ripgrep 依赖，自动加载对应平台的 ripgrep版本（推荐方案）

稍后，我将根据推荐的解决方案修复该问题。

[sobird]

最终优雅的解决方案：

bun add @vscode/ripgrep

编辑 src/utils/ripgrep.ts

import { rgPath } from "@vscode/ripgrep";

...

// const rgRoot = path.resolve(__dirname, 'vendor', 'ripgrep')
  // const command =
  //   process.platform === 'win32'
  //     ? path.resolve(rgRoot, `${process.arch}-win32`, 'rg.exe')
  //     : path.resolve(rgRoot, `${process.arch}-${process.platform}`, 'rg')

  return { mode: 'builtin', command: rgPath, args: [] }