What problem does it solve?
Prevents accidental or out-of-scope modifications by blocking Edit and Write operations that target files outside a user-specified directory during the session. This is useful when debugging, working on a single module, or when you want to limit the AI's editable surface to a focused area.
Core Features & Use Cases
- Session-scoped edit restriction: Asks the user for a directory and enforces that subsequent Edit and Write tool actions only affect files under that path.
- PreTool hooks: Runs a hook script before Edit/Write to examine the tool input and return a permissionDecision deny for disallowed paths.
- Persistent boundary state: Stores the resolved absolute freeze path in a state file so the boundary is checked for the duration of the session.
- Use Case: When debugging a bug in a single package, freeze to that package directory to ensure automated edits or fixes do not touch other parts of the repository.
Quick Start
Freeze edits to the directory /src so that any Edit or Write outside /src will be blocked.