Conversation Management 💬¶

Browse, search, and manage Claude Code conversations.

Commands¶

conv ls¶

List conversations.

# List conversations for current project
tclaude conv ls

# Interactive watch mode
tclaude conv ls -w

# Global - all projects
tclaude conv ls -g

# Global interactive
tclaude conv ls -g -w

# Limit results
tclaude conv ls -n 10

# Filter by time
tclaude conv ls --since 7d
tclaude conv ls --before 2024-01-01

Flags:

Flag	Description
`-w, --watch`	Interactive watch mode
`-g, --global`	Search all projects
`-n, --count`	Limit number of results
`--since`	Show only after this time
`--before`	Show only before this time

conv search¶

Search conversation content.

# Search in current project
tclaude conv search "authentication"

# Search globally
tclaude conv search -g "authentication"

# Search with time filter
tclaude conv search --since 24h "bug fix"

# Full content search (slower, more thorough)
tclaude conv search --content "specific error message"

Flags:

Flag	Description
`-g, --global`	Search all projects
`--content`	Search full conversation content
`--since`	Filter by time
`--before`	Filter by time

conv resume¶

Resume a conversation in a new Claude session.

# Resume by ID (creates a new tmux session)
tclaude conv resume <conv-id>

# Resume detached
tclaude conv resume -d <conv-id>

This is equivalent to tclaude session new --resume <conv-id>.

conv delete¶

Delete a conversation.

# Delete by ID
tclaude conv delete <conv-id>

# Skip confirmation
tclaude conv delete -y <conv-id>

# Search globally
tclaude conv delete -g <conv-id>

conv prune-empty¶

Delete conversations with no messages.

# Prune current project
tclaude conv prune-empty

# Prune globally
tclaude conv prune-empty -g

# Preview only (dry run)
tclaude conv prune-empty --dry-run

conv cp / conv mv¶

Copy or move conversations.

# Copy a conversation
tclaude conv cp <conv-id> /path/to/dest

# Move a conversation
tclaude conv mv <conv-id> /path/to/dest

Interactive Watch Mode¶

Press w or use -w flag to enter interactive mode.

Key	Action
`↑`/`k`	Move up
`↓`/`j`	Move down
`PgUp`/`Ctrl+B`	Page up
`PgDn`/`Ctrl+F`	Page down
`g`/`Home`	Go to first
`G`/`End`	Go to last
`Enter`	Create/attach to session
`q`/`Esc`	Quit

Search¶

Key	Action
`/`	Start text search (title, prompt, project, branch, ID)
`s`	Start semantic search (requires Ollama)
`Esc`	Clear search / exit search or semantic mode
`Ctrl+U`	Clear search input
`↑`/`↓`	Exit search and navigate

Text search (/) matches against: title, first prompt, project path, git branch, session ID.

Semantic search (s) finds conversations by meaning using local embeddings. See Semantic Search for setup and details.

Actions¶

Key	Action
`Del`/`x`	Delete conversation
`r`	Refresh list
`h`/`?`	Show help

Delete Confirmation¶

When deleting a conversation:

No active session: y to confirm, n to cancel
Has active session:
y - Delete conversation AND stop session
s - Stop session only (keep conversation)
n - Cancel

Session Indicators ⚡¶

In the conversation list, indicators show session status:

Indicator	Meaning
⚡	Conversation has an attached session (someone's watching!)
○	Conversation has an active session (running in background)
(none)	No active session

Time Filters¶

Commands support flexible time formats:

Format	Example	Description
Duration	`24h`, `7d`, `2w`	Relative time
Date	`2024-01-15`	Specific date
DateTime	`2024-01-15T10:30`	Date and time

# Last 24 hours
tclaude conv ls --since 24h

# Last week
tclaude conv ls --since 7d

# Before a specific date
tclaude conv ls --before 2024-01-01

# Date range
tclaude conv ls --since 2024-01-01 --before 2024-02-01

Session ID Formats¶

Conversations can be referenced by:

Full ID: abc12345-def6-7890-abcd-ef1234567890
Short prefix: abc12345 (if unique)
Autocomplete format: abc12345_[project]_prompt... (from shell completion)

Shell completions automatically provide the full format with context.