Feature: Auto-title sessions from CWD or project metadata

Resolved 💬 3 comments Opened Feb 8, 2026 by mgmead Closed Feb 11, 2026

Feature Request

Auto-title CLI sessions based on project context

Problem

When working across multiple projects, sessions default to unnamed (or get titled by initial prompt), making it hard to find them later in /resume. Users working in project-structured directories have to manually /rename every session — friction that adds up.

Proposed Solution

Auto-derive a session title on start from one of (in priority order):

  1. project_name field in local CLAUDE.md — explicit, user-controlled
  2. CWD basename — zero-config fallback (e.g., ~/Documents/Tech/Claude Projects/documents-cleanup/documents-cleanup)

The auto-title would behave like a default — still overridable with /rename.

Alternatives Considered

  • SessionStart hook — hooks can echo reminders but can't set the session title programmatically
  • Manual /rename — works but adds cognitive and mechanical load every session

Use Case

Users with project-based workflows (monorepos, multi-project directories, landed conversations) benefit from sessions that self-identify. This is especially valuable when resuming sessions across days or switching between projects frequently.

Additional Context

A project_name field in CLAUDE.md could serve double duty — session titles, status line display, logging, etc.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗