# Code Search

> Code Search is an Agent Skill for development published in the agentscope-ai/agentscope-java repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Search a codebase efficiently with ripgrep regular expressions, file globs, and git history search. Use to locate symbols, usages, and definitions instead of reading whole files.

- Skill name: `code-search`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/agentscope-ai/agentscope-java/blob/HEAD/agentscope-examples/agents/agentscope-codingagent/src/main/resources/workspace-templates/skills/code-search/SKILL.md
- Repository: agentscope-ai/agentscope-java (4,490 GitHub stars when collected)

## SKILL.md

# Code Search

The built-in `grep` tool matches LITERAL text only. For real regular-expression search and
history-aware lookups, drive ripgrep and git through `execute`.

## Ripgrep (regex)

- Symbol definition: `rg -n "fn\s+\w+\(" src/`, `rg -n --type java "class \w+Service"`.
- Usages of a name: `rg -n "\bmyFunction\b"`.
- Limit by file type: `rg -n --type ts "useEffect\("`.
- List files only: `rg -l "TODO"`; find files by name: `rg --files | rg <name>` or use `glob`.

## Git history search

- When a string was introduced/removed: `git log -S "<string>" --oneline`.
- Who/why a line changed: `git blame -L <start>,<end> <file>`.
- Search tracked files: `git grep -n "<regex>"`.

## Tips

- Prefer a targeted regex over reading whole files when locating symbols or call sites.
- Escape regex metacharacters when you want a literal match, or pass `-F` to ripgrep.
- Narrow scope with a path argument to keep output small (tool output is truncated).

---

Source: https://www.openparable.com/skill/development/code-search (OpenParable). Cite the canonical URL above.
