Skip to content

Feature: agent-deck session move command for path migration #414

@rayangc

Description

@rayangc

Problem

When moving/reorganizing project directories, migrating an agent-deck session to a new path requires 4 manual steps:

  1. agent-deck session set <name> path /new/path
  2. agent-deck group move <name> <new-group> (optional)
  3. Manually copy ~/.claude/projects/<old-encoded>/~/.claude/projects/<new-encoded>/ to preserve Claude session history
  4. agent-deck session restart <name>

Step 3 is particularly error-prone — you have to know about Claude Code's encoded path scheme (/-) and manually construct the directory names. Most users won't know this exists.

Proposal

Add a session move command that handles the full migration:

agent-deck session move <id_or_title> /new/path [--group <new-group>]

This would:

  1. Update the session's path in agent-deck's database
  2. Detect and migrate Claude Code session history (~/.claude/projects/ encoded directories)
  3. Optionally move to a new group if --group is specified
  4. Restart the session

Flags

  • --group <name> — also move to a different group
  • --no-restart — skip the automatic restart
  • --copy — copy session history instead of moving (preserve old path data for other sessions that may share it)

Context

Claude Code stores session history in ~/.claude/projects/ using path-encoded directory names. Anthropic has marked the built-in migration feature request as NOT_PLANNED (anthropics/claude-code#1516), so this is something the session manager could handle instead.

Tested the manual migration process and confirmed it works — Claude --resume picks up the old conversation history after the encoded directory is renamed/copied.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions