smart-rename

Manage Claude Code session titles with domain anchors and rename controls.

2|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/fernando-bertholdo/4-successful-AI-life --skill smart-rename
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-rename
Source: https://github.com/fernando-bertholdo/4-successful-AI-life/tree/main/plugins/smart-session-rename-cc/skills/smart-rename
Command: npx skills add https://github.com/fernando-bertholdo/4-successful-AI-life --skill smart-rename

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Managing Claude Code session titles and domain naming is error-prone and inconsistent; smart-rename provides automatic suggestions, anchors, and controls to keep titles aligned with content.

Core Features & Use Cases

  • Suggest domain anchors for current sessions to improve discoverability and organization.
  • Set, anchor, freeze, or force a session title to reflect the active work context.
  • Explain recent rename decisions to provide transparency and auditability for teams.

Quick Start

Use the smart-rename command to generate and apply a domain anchor for your current Claude Code session.

Frequently Asked Questions about smart-rename

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Claude Code session title management?

Automate Claude Code session title management by using a CLI script to suggest and apply domain anchors that align session names with active work context. The tool runs as a foreground process with required environment variables to update titles interactively.

What are domain anchors and how do they improve session discoverability?

Domain anchors are fixed naming references applied to Claude Code sessions to improve organization and discoverability. They keep session titles aligned with content by providing consistent, context-aware labels that reflect the active work being performed.

Can I freeze or force a Claude Code session title?

Yes, you can freeze automatic renaming or force a specific session title using the CLI script. These controls let you anchor a domain name permanently or override the current state to maintain consistent session identification across interactive workflows.

How do I explain recent rename decisions for Claude Code sessions?

Explain recent rename decisions by running the CLI script's explain command, which provides transparency and auditability for session title changes. This feature shows the reasoning behind automatic or manual domain anchor updates applied to the session.

Does smart-rename work with bash and CLI environments?

Yes, the tool executes against a local bash CLI script and requires specific environment variables set for foreground execution. It integrates directly with interactive Claude Code sessions to manage domain anchors without additional dependencies.

When should I not use automatic session title suggestions?

Avoid automatic session title suggestions when you need persistent, unchanging identifiers across sessions or when environment variables required for foreground CLI execution are not configured. Use the freeze or force commands instead to maintain stable names.