/find-similar

What makes find similar unique

Unlike traditional search tools that look for exact matches, Find Similar:

Analyzes semantic code patterns and logic flow, not just syntax
Identifies similar implementations across different programming languages
Finds functionally equivalent code even with different variable names or structure
Understands architectural patterns and design similarities
Traces similar business logic implementations across components

API/MCP reference

Request format

{
  "tool": "find_similar", 
  "parameters": {
    "input": "async function handleUserLogin(email, password) {\n  const user = await User.findByEmail(email);\n  if (!user || !await bcrypt.compare(password, user.passwordHash)) {\n    throw new Error('Invalid credentials');\n  }\n  return generateJWT(user);\n}",
    "repositories": ["backend/auth", "frontend/components"],
    "session_id": "similarity-analysis-456"
  }
}

Parameters

Parameter	Type	Required	Description
`input`	string	Yes	Code snippet, function, or textual description of the pattern/logic you want to find similar implementations of
`repositories`	array	No	List of repository identifiers to search within. Format: `org/repo`
`session_id`	string	No	Unique identifier to maintain context across multiple similarity searches

Response format

{
  "agent_summery": "Found 8 similar authentication patterns across your codebase...",
  "findings": [
    {
      "repo_name": "backend/auth",
      "file_path": "src/controllers/authController.js", 
      "similarity_score": 0.92,
      "code_snippet": "// Similar login implementation...",
      "reason": "Nearly identical authentication flow with email lookup and password comparison",
      "line_range": [15, 28]
    },
    {
      "repo_name": "mobile/app",
      "file_path": "lib/services/auth_service.dart",
      "similarity_score": 0.78, 
      "code_snippet": "// Dart equivalent authentication...",
      "reason": "Similar authentication logic implemented in Dart with same validation pattern",
      "line_range": [42, 58]
    }
  ]
}

Recommended analysis strategies

Include complete code context - Provide full functions or classes rather than isolated lines for better pattern matching
Specify target repositories - Focus searches on relevant codebases to improve accuracy and performance
Use descriptive input - Natural language descriptions work alongside code snippets for broader pattern discovery
Leverage session continuity - Use session_id when performing iterative similarity analysis across related components
Combine with architectural context - Include surrounding code structure for finding architectural pattern similarities

Usage examples

Finding similar API endpoints

{
  "input": "GET endpoint that validates user permissions, fetches data from database, and returns JSON response with error handling",
  "repositories": ["api/v1", "api/v2", "microservices/user-svc"],
  "session_id": "api-pattern-search"
}

Locating similar algorithm implementations

{
  "input": "function quickSort(array) {\n  if (array.length <= 1) return array;\n  const pivot = array[Math.floor(array.length / 2)];\n  const left = array.filter(x => x < pivot);\n  const right = array.filter(x => x > pivot);\n  return [...quickSort(left), pivot, ...quickSort(right)];\n}",
  "repositories": ["algorithms/sorting", "utils/array-helpers"]
}

Finding similar business logic

{
  "input": "Calculate shipping cost based on weight, distance, and delivery speed with promotional discount application",
  "repositories": ["ecommerce/pricing", "logistics/shipping"],
  "session_id": "business-logic-review"
}

Core concepts

Plans and resources

What makes find similar unique

API/MCP reference

Request format

Parameters

Response format

Recommended analysis strategies

Finding similar API endpoints

Locating similar algorithm implementations

Finding similar business logic

​What makes find similar unique

​API/MCP reference

​Request format

​Parameters

​Response format

​Recommended analysis strategies

​Finding similar API endpoints

​Locating similar algorithm implementations

​Finding similar business logic

What makes find similar unique

API/MCP reference

Request format

Parameters

Response format

Recommended analysis strategies

Finding similar API endpoints

Locating similar algorithm implementations

Finding similar business logic