About this project

Chisel is an open‑source collection of LLDB commands created by Facebook to simplify debugging iOS (and macOS) applications. After installing via Homebrew (`brew install chisel`) users add a single import line to their `~/.lldbinit` file, after which the commands become available in Xcode or a standalone LLDB session. The command set includes utilities for inspecting the view hierarchy (`pviews`, `pvc`), locating specific views or view controllers (`fv`, `fvc`), visualising UI elements (`visualize`, `show/hide`, `mask/unmask`, `border/unborder`), forcing layout updates (`caflush`), setting symbolic breakpoints (`bmessage`), watching instance variables (`wivar`), and printing responder chains (`presponder`). Each command has detailed help text and optional arguments. Developers can also create custom commands by placing Python scripts in a directory and loading them with `loadCommandsInDirectory`. The typical workflow is to pause at a breakpoint, source `~/.lldbinit`, run a command, edit the script, and optionally reload the module. The project welcomes contributions of generic debugging commands and follows the MIT license. Full documentation, a command list, and contribution guidelines are available on the repository’s wiki and `CONTRIBUTING.md`.