Comby
comby.dev
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What Comby is
Comby is a free, open-source tool for searching and changing code structure with lightweight templates. It understands basic syntax in code, strings, comments, and balanced delimiters such as parentheses, brackets, and braces. Basic parsers are listed for C/C++, C#, Go, Java, JavaScript, Python, Rust, Swift, and TypeScript, while a generic matcher handles other formats. Comby is intended for large-scale refactoring and one-off code changes, with an interactive review mode for proposed edits. You can use its command line, Python bindings, or HTTP requests to a server on your machine. Installation instructions cover macOS, Ubuntu, Windows through Ubuntu on WSL, and Docker; building from source is also described. Listed uses include structural code search, compiler fuzzing, test case reduction, editor find and replace, and academic research. It supports API, Linux, macOS, self-hosted, and Windows use, and can search a codebase with regex.
Who it suits
Comby suits developers who need structural search, refactoring, or code-change automation across supported languages. It also fits teams integrating code operations through Python, HTTP, editors, or self-hosted services.
Good to know, and what to watch
- Free and open source
- Matches code structure and balanced delimiters
- Interactive review for proposed changes
- Command line, Python, and HTTP interfaces
- Supports multiple installation methods
- Indentation is not treated as significant
- Rewrite ranges report line and column as -1
- Not suited to formatting changes
- Prototype VS Code extension
The verdict
Comby focuses on structural matching and controlled rewrites rather than text formatting. Its language parsers, generic matcher, review mode, and integration options make it suitable for refactoring and code-search workflows, with documented API and indentation limitations.
What the maker publishes
- API limitation
- The API documentation says rewrite ranges currently report line and column as -1, and repeated hole identifiers in a rewrite template currently report only the first range. source
- Best-fit work
- Comby is suited to coarse syntactic matching and refactoring, while the FAQ says it is not well-suited to styling or formatting changes such as inserting line breaks at a set width. source
- Editor integrations
- The projects page links to an Emacs package and a prototype VS Code extension. source
- Installation
- The getting-started page documents installation on macOS with Homebrew, Ubuntu with a shell installer, Windows through Ubuntu on WSL, and Docker. source
- Install options
- The site provides installation instructions for macOS, Ubuntu, Windows through Ubuntu on WSL, and Docker, and also describes building from source. source
- Integration
- Comby can be used through Python bindings, its command line, or HTTP requests to a server run on the user's machine. source
- Integration options
- Comby provides an API reference for building or integrating other tools, and the projects page lists an Emacs package and a prototype VS Code extension. source
- Interactive review
- Comby supports an interactive review mode for proposed changes. source
- Language awareness
- It understands basic syntax for code, strings, and comments across many languages. source
- Language awareness
- Comby understands basic syntax for code, strings, and comments in many languages. source
- Language coverage
- Comby lists basic parsers for languages including C/C++, Go, JavaScript, Python, Rust, and TypeScript, with a generic matcher for other formats. source
- Language support
- Comby has basic parsers for languages including C/C++, C#, Go, Java, JavaScript, Python, Rust, Swift, and TypeScript, plus a generic matcher for other formats and languages. source
- License
- The public comby-tools/comby GitHub repository identifies its license as Apache-2.0. source
- Notable limitation
- Comby does not currently treat indentation as significant, which limits support for matching indentation-sensitive structures such as Python blocks. source
- Purpose
- Comby searches and changes code structure using lightweight templates. source
- Purpose
- Comby is a tool for searching and changing code structure using lightweight templates. source
- Refactoring
- The site describes Comby as useful for large scale refactoring and one off code changes. source
- Rewrite helpers
- Built-in rewrite properties can change letter case and provide match lengths, positions, and file context. source
- Security and compliance
- The opened product and documentation pages do not state security certifications or compliance claims. source
- Self hosting
- The project can be built from source, and the getting-started page describes building it for other platforms or local development. source
- Structural matching
- Comby matches balanced delimiters such as parentheses, brackets, and braces while accounting for comments and string literals. source
- Support
- The help page directs users to the Gitter channel for usage questions and help writing patterns. source
- Support
- The help page directs users to the Gitter channel for usage questions and pattern-writing help, and to GitHub issues for installation problems. source
- Use cases
- The projects page lists structural code search, compiler fuzzing, test case reduction, editor find and replace, and academic research among Comby's uses. source
Checked against the maker's pages on 8 Oct 2026.