rename-category

Renames a session category across config, folders, notes frontmatter, and active-sessions.json.

6|1|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill rename-category-t-mercier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rename-category
Source: https://github.com/t-mercier/ai-agents-orchestrator/tree/main/skills/rename-category
Command: npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill rename-category-t-mercier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Renaming a session category in the AI Agents Orchestrator dashboard only edits the shared config, which orphans every existing session because their folders, notes frontmatter, and active-sessions entries still point at the old name. This Skill performs the actual migration so nothing is left dangling. ## Core Features & Use Cases - Dry-run planning: Validates that the old category exists and the new name is free and valid, then prints the folder move, the number of notes to re-tag, active-sessions entries, and any running sessions before touching anything. - Full migration: Moves the category folder, rewrites the category: line in every session's notes.md frontmatter, updates matching entries in ~/.claude/active-sessions.json (including notes_path), and renames the category in the config while keeping its color and scope. - Safety guards: Refuses to run when a category name exists under multiple spaces, aborts if the destination folder already exists, warns about running sessions whose working directory would go stale, and writes all JSON atomically. - Use Case: You want to rename your FEAT category to FEATURE across a dozen sessions. Run the plan step, confirm no sessions are running, then apply — every reference is migrated in one pass. ## Quick Start Ask the assistant to rename category FEAT to FEATURE, review the dry-run plan it shows, and confirm to apply the migration.

Frequently Asked Questions about rename-category

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

FAQPage Schema
How do I rename a session category without orphaning sessions?

Run the rename-category skill with the old and new names. It first prints a dry-run plan, then on confirmation moves the category folder, re-tags every notes.md frontmatter, updates active-sessions.json, and renames the category in the shared config.

Why does renaming a category in the dashboard make sessions disappear?

The dashboard is read-only on session data and only edits the config entry. Existing sessions still reference the old category name in their folders and notes, so they no longer match and appear orphaned. This skill migrates those references.

Can I rename a category while sessions are still running?

It is not recommended. Renaming moves the folder out from under a live process, leaving its working directory stale. The plan step lists running sessions in that category so you can close them before applying.

What happens if the same category name exists in multiple spaces?

The script refuses to run and prints an error. Because it resolves folders by scope rather than root, it cannot disambiguate duplicates safely; you must remove the duplicate via the dashboard settings first.

What are the naming rules for a new category name?

The new name must match letters, digits, underscores, or hyphens with a maximum of 20 characters, and it must not already exist in the config. Invalid or duplicate names are rejected during the plan step.