bb
Backbencher
API Reference

13 Surgical Precision Tools

Every tool designed for exact AST manipulation. No regex, no guessing, no breaking your code.

Discovery

bb_search

AST-aware symbol search across your entire codebase

Overview

Search across your entire codebase with AST-aware precision. Unlike grep or regex, bb_search understands code semantics and relationships.

Features

  • Semantic code search across 32+ languages
  • Function, class, and symbol discovery
  • Cross-file relationship tracking

Parameters

ParameterTypeRequiredDescription
--querystring
Required
Search query (function name, class, pattern)
--scopestring
Optional
Limit scope: functions, classes, files, semantic
--languagestring
Optional
Filter by language (typescript, python, etc)
--limitnumber
Optional
Max results to return (default: 20)

Examples

Example 1
$ bb_search --query="login" --scope="functions"
→ Found 12 functions matching "login" in 45ms
Example 2
$ bb_search --query="AuthService" --language="typescript"
→ Found 3 classes, 8 method references