OpenParable
Skip to content
← Back to skills

Code Search

Development
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/agentscope-ai/agentscope-java/blob/HEAD/agentscope-examples/agents/agentscope-codingagent/src/main/resources/workspace-templates/skills/code-search/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/code-search, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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).