# Smart Rename

> Manage the smart-session-rename plugin — suggest, anchor, freeze, force, explain.

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

---


# /smart-rename (v1.5)

When the user invokes `/smart-rename [args]`, run the matching command via the Bash tool and report the output verbatim. Pass `$CLAUDE_TRANSCRIPT_PATH` as the last argument.

## Subcommands

### `/smart-rename` — suggest (consumes 1 budget slot)

**IMPORTANT**: This command calls an inner `claude -p` process that takes 30-90 seconds to complete (the child process must initialize its own plugin stack + create prompt cache). You MUST:
1. Run this Bash command in **foreground** (NOT background)
2. Set the Bash tool **timeout to at least 120 seconds**

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh "" "$CLAUDE_TRANSCRIPT_PATH" "${CLAUDE_PROJECT_DIR:-$PWD}"
```

### `/smart-rename <name>` — set domain anchor
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh "<name>" "$CLAUDE_TRANSCRIPT_PATH"
```

### `/smart-rename freeze` / `unfreeze`
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh freeze "$CLAUDE_TRANSCRIPT_PATH"
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh unfreeze "$CLAUDE_TRANSCRIPT_PATH"
```

### `/smart-rename force`
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh force "$CLAUDE_TRANSCRIPT_PATH"
```

### `/smart-rename explain`
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh explain "$CLAUDE_TRANSCRIPT_PATH"
```

### `/smart-rename unanchor`
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/smart-rename-cli.sh unanchor "$CLAUDE_TRANSCRIPT_PATH"
```

If the CLI exits non-zero, report the error message verbatim. Do not retry automatically.