search-code

Search GitHub Code

Name

github:search-code - Search for code across GitHub repositories

Synopsis

/search-code [arguments]

Description

Search for code across GitHub repositories

Implementation

Search for code, files, or implementations across GitHub repositories.

Usage

/search-code [query]

This command helps you find relevant code across repositories.

What This Command Does

1. Accepts a search query (keywords or GitHub search syntax)
2. Searches across accessible repositories using search_code
3. Returns relevant code snippets with:
   • File paths and line numbers
   • Repository names
   • Code context around matches
   • Links to view full files

Prerequisites

• GitHub MCP server must be installed and configured
• OAuth authentication must be completed

Example Interaction

User: /search-code JWT token validation

Claude: Searching for "JWT token validation"...

Found 4 relevant code snippets:

### 1. my-org/auth-service - src/middleware/validateToken.ts
```typescript
export function validateJWT(token: string): UserPayload {
  try {
    const decoded = jwt.verify(token, process.env.JWT_SECRET);
    return decoded as UserPayload;
  } catch (error) {
    throw new UnauthorizedError('Invalid token');
  }
}

2. my-org/api-gateway - lib/security/jwt.ts

async function verifyToken(req: Request): Promise<boolean> {
  const token = req.headers.authorization?.split(' ')[1];
  if (!token) return false;
  return await jwt.verify(token, publicKey, { algorithms: ['RS256'] });
}

Would you like to see more results or explore any of these files?

## Search Syntax

GitHub code search supports advanced syntax:

- **Exact phrase**: `"function authenticate"`
- **File type**: `language:typescript`
- **Path filter**: `path:src/auth`
- **Repository**: `repo:owner/repo-name`
- **Organization**: `org:my-org`
- **Extension**: `extension:ts`

### Examples

Find all TypeScript files with "authenticate"

authenticate language:typescript

Search in specific path

validate path:src/middleware

Search specific repository

JWT repo:my-org/auth-service

Combine filters

async function org:my-org language:javascript

## Tips

- Use specific keywords for better results
- Filter by language to reduce noise
- Search across an organization with `org:`
- Combine with path filters to narrow scope
- Use quotes for exact phrases
- Review multiple implementations for patterns

## Related Commands

- `/review-pr`: Review PRs that modify found code
- `/create-issue`: File issues for problems found
- `/create-pr`: Create PR to fix or improve code