Skip to content

[Future] Session naming feature #37

@frankbria

Description

@frankbria

Overview

Allow users to name their Claude Code sessions for easier identification when running multiple parallel sessions.

Usage

# Start named session
claude-parallel --name "backend-auth"
claude-parallel --name "frontend-refactor"

# Status shows names
$ parallel-cc status
Active Sessions: 2
  ● backend-auth (PID 12345) - 15 minutes
    Path: /home/user/project-worktrees/parallel-backend-auth
  ● frontend-refactor (PID 12346) - 8 minutes
    Path: /home/user/project-worktrees/parallel-frontend-refactor

Benefits

  • Easier to identify which terminal is which
  • Better logging and tracking
  • Named worktree directories
  • Clearer commit/PR associations

Implementation Notes

  • Store name in sessions table
  • Use name in worktree directory suffix
  • Display name in all status output
  • Optional: Default name from current git branch

Database Changes

ALTER TABLE sessions ADD COLUMN session_name TEXT;

Acceptance Criteria

  • `--name` flag works with claude-parallel
  • Name appears in status output
  • Worktree directory includes name
  • MCP tools return session name
  • Name is optional (auto-generated if not provided)

Dependencies

None

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions