Codebase Exploration

Efficiently explore the codebase using Glob and Grep tools.

Glob Tool

Find files by pattern:

# Find all TypeScript files
Glob("**/*.ts")

# Find all TSX files
Glob("**/*.tsx")

# Find specific folders
Glob("src/components/**/*.tsx")
Glob("src/hooks/**/*.ts")

# Find files with keyword
Glob("**/*player*")
Glob("**/*physics*")

Grep Tool

Search file contents:

# Search for specific text
Grep("useFrame", "src/")
Grep("useState", "src/")

# Case-insensitive search
Grep("COLYSEUS", "src/", { ignoreCase: true })

# Search with context
Grep("function.*movement", "src/", { context: 2 })

Search Patterns

Find Component Definitions

Grep("function.*Component|const.*=.*=>", "src/components/")

Find State Stores

Glob("src/stores/**/*.ts")
Grep("create.*Store|zustand", "src/stores/")

Find Type Definitions

Glob("src/types/**/*.ts")
Grep("interface.*|type.*=", "src/types/")

Find Exports

Grep("export.*function|export.*const", "src/")

Tips

1. Start broad, then narrow - Use Glob first, then Grep
2. Use specific patterns - More specific = faster results
3. Check multiple locations - Code may be in unexpected places
4. Read related files - Found patterns often have related code nearby

Anti-Patterns

❌ DON'T:

• Use overly broad globs -

  Glob("**/*")

  is useless
• Search from root every time - Narrow to relevant directories
• Ignore file extensions - Searching

  .md

  files for code patterns wastes time
• Skip context - Reading just the matched line misses important context
• Search for common words -

  Grep("const")

  returns everything

✅ DO:

• Combine Glob + Grep -

  Glob("src/**/*.ts")

  then

  Grep("pattern", "src/")

• Use specific globs -

  Glob("src/components/**/*.tsx")

  instead of

  Glob("**/*.tsx")

• Search with context -

  Grep("pattern", "src/", { context: 3 })

• Filter by file type - Search

  .ts

  files for code,

  .md

  for docs
• Start from known locations - Check similar features first