CLI Overview
All commands support these global flags:
| Flag | Description |
|---|---|
--json | Output in JSON format |
--quiet | Suppress non-essential output |
--verbose | Show detailed progress |
--server <URL> | Use remote bobbin server (thin-client mode) |
Commands
| Command | Description |
|---|---|
bobbin init | Initialize bobbin in current repository |
bobbin index | Build/rebuild the search index |
bobbin search | Hybrid search (combines semantic + keyword) |
bobbin context | Assemble task-relevant context from search + git coupling |
bobbin grep | Keyword/regex search with highlighting |
bobbin deps | Import dependency analysis |
bobbin refs | Symbol reference resolution |
bobbin related | Find files related to a given file |
bobbin history | Show commit history and churn statistics |
bobbin hotspots | Identify high-churn/complexity code |
bobbin impact | Predict which files are affected by a change |
bobbin review | Assemble review context from a git diff |
bobbin similar | Find semantically similar code or detect duplicates |
bobbin status | Show index statistics |
bobbin serve | Start MCP server for AI agent integration |
bobbin tour | Interactive tour of bobbin features |
bobbin prime | Generate LLM-friendly overview with live stats |
bobbin benchmark | Run embedding benchmarks |
bobbin watch | Watch mode for automatic re-indexing |
bobbin completions | Generate shell completions |
bobbin hook | Claude Code hook integration |
Supported Languages
Bobbin uses Tree-sitter for structure-aware parsing, and pulldown-cmark for Markdown:
| Language | Extensions | Extracted Units |
|---|---|---|
| Rust | .rs | functions, impl blocks, structs, enums, traits, modules |
| TypeScript | .ts, .tsx | functions, methods, classes, interfaces |
| Python | .py | functions, classes |
| Go | .go | functions, methods, type declarations |
| Java | .java | methods, constructors, classes, interfaces, enums |
| C++ | .cpp, .cc, .hpp | functions, classes, structs, enums |
| Markdown | .md | sections, tables, code blocks, YAML frontmatter |
Other file types fall back to line-based chunking (50 lines per chunk with 10-line overlap).