claude-code - 💡(How to fix) Fix [DOCS] Agent view deletion docs say deleted sessions remain resumable

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

"Monitor sessions with agent view" deletion instructions, plus the claude rm <id> command description

Current Documentation

The docs currently say:

To remove a session from the list, press Ctrl+X to stop it and Ctrl+X again within two seconds to delete it. Pressing Ctrl+X on a group header deletes every session in that group after confirmation.

Deleting removes the session from agent view and cleans up its worktree, including any uncommitted changes in it, so push or commit work you want to keep before deleting. The conversation transcript stays on disk and remains available through claude --resume.

The command reference on the same page also says:

| claude rm <id> | Remove a session from the list. Cleans up its worktree if there are no uncommitted changes |

What's Wrong or Missing?

The current agent-view docs conflict with the v2.1.143 changelog entry:

Fixed deleting a session from agent view not removing its transcript file

That changelog entry indicates that deleting a session from agent view now removes the transcript file. The current docs still say the opposite: that deleting a session leaves the transcript on disk and keeps it available through claude --resume.

This creates a user-facing contradiction in the deletion workflow:

A. The delete behavior appears to have changed, but the docs still describe the old behavior

Users reading the current page are told that deleting a session only removes it from agent view while preserving the transcript for later resume.

B. The claude rm <id> description does not clarify transcript deletion semantics

Because claude rm <id> is the shell equivalent of removing a background session, its reference should match the updated deletion behavior too.

Suggested Improvement

Update the agent-view deletion docs to match the current behavior introduced by v2.1.143.

Before:

Deleting removes the session from agent view and cleans up its worktree, including any uncommitted changes in it, so push or commit work you want to keep before deleting. The conversation transcript stays on disk and remains available through claude --resume.

After:

Deleting removes the session from agent view, cleans up its worktree, and deletes the local transcript file, so the session is no longer available through claude --resume.

Also update the claude rm <id> command description to make the same deletion semantics explicit, and add a short warning telling users to stop or export a session instead of deleting it if they want to keep the conversation history.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

Total scope: 2 pages affected

Source: Changelog v2.1.143

Exact changelog entry:

Fixed deleting a session from agent view not removing its transcript file