# Unfreeze

> Remove the workspace edit-boundary lock created by `freeze`. Clears `.cursor/freeze-scope.json` and restores normal write scope. Uses safe confirmation behavior and cross-platform Bash/PowerShell command branches. Trigger: unfreeze, unlock scope, 解除限制, 取消冻结.

- Skill: `romeosy/unfreeze` (Agent Skill)
- Install (CLI): `npx skillmds@latest add romeosy/unfreeze`
- Raw SKILL.md: https://api.skillmd.com/api/skills/romeosy/unfreeze/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: RomeoSY (https://skillmd.com/u/romeosy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/romeosy/unfreeze

---


# Unfreeze

You are a scope unlock tool. Remove active freeze boundaries safely.

## Safety Policy

1. Show current lock state before deleting it.
2. If no lock exists, report "already unfrozen" and stop.
3. Do not run unrelated mutating actions.

## Step 1: Read Current Lock

- Check `.cursor/freeze-scope.json`.
- If found, report `allowedRoot` and `createdAt`.

## Step 2: Remove Lock

### Bash

```bash
python "$HOME/.cursor/skills/freeze/bin/clear_freeze_scope.py" \
  --state-file ".cursor/freeze-scope.json"
```

### PowerShell

```powershell
python "$env:USERPROFILE\\.cursor\\skills\\freeze\\bin\\clear_freeze_scope.py" `
  --state-file ".cursor/freeze-scope.json"
```

## Step 3: Confirm Status

Report final state:
- `active` -> `inactive`
- write scope restored to normal workspace behavior

## Git Note (when follow-up git actions are requested)

Resolve base branch dynamically before any mutating git operation:

### Bash

```bash
BASE_BRANCH="$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')"
[ -z "$BASE_BRANCH" ] && BASE_BRANCH="main"
```

### PowerShell

```powershell
$BASE_BRANCH = (git symbolic-ref refs/remotes/origin/HEAD 2>$null) -replace '^refs/remotes/origin/',''
if (-not $BASE_BRANCH) { $BASE_BRANCH = "main" }
```

## Output Format

**Use Chinese headings inside the fence for Chinese-speaking users.**

```markdown
## 解除冻结结果（Unfreeze）
- 此前锁状态：存在 / 不存在（present / absent）
- 是否已移除：是 / 否（yes / no）
- 当前状态：未冻结（inactive）
```