Chat Commands

Simplified command for chatting with LLM agents.

Basic Usage

tdx chat <message> [options]

Options

Option	Description	Default
--agent <name>	Chat with specific agent	default agent
--model <name>	Model or alias (haiku, sonnet, opus)	haiku
--temperature <n>	Temperature (0.0-2.0)	0.7
--new	Start a new chat session	-

Examples

# Simple chat (uses default agent with claude-4.5-haiku)
tdx chat "Show me the top customers by revenue"

# Continue previous conversation (default behavior)
tdx chat "What about last quarter?"

# Start a new conversation
tdx chat --new "Tell me about data modeling best practices"

# Use model aliases for quick access
tdx chat "Quick question" --model "haiku"     # Uses claude-4.5-haiku
tdx chat "Analyze this" --model "sonnet"      # Uses claude-4.5-sonnet

# Use full model name
tdx chat "Help me write SQL" --model "claude-4.5-opus"

# Use specific agent by name
tdx llm use "MyProject"
tdx chat "Analyze churn" --agent "Data Analyst"

# Override project for agent lookup
tdx chat "Hello" --agent "Analyst" --llm-project "OtherProject"

# Adjust temperature (lower=focused, higher=creative)
tdx chat "Write a poem" --temperature 1.5

# Verbose mode shows chat session ID
tdx chat "Hello" --verbose

How It Works

• Default behavior: Continues last chat session automatically
• Session persistence: Last chat ID saved to .cache/tdx/last_chat_id
• --new flag: Starts a fresh chat session
• --agent: Use specific agent by name (resolves using project context)
• --model: Auto-creates/reuses agent per model

Model Aliases

Alias	Model
haiku	claude-4.5-haiku
sonnet	claude-4.5-sonnet
opus	claude-opus

Temperature

• Lower values (0.0-0.5): More focused, deterministic responses
• Default (0.7): Balanced creativity and coherence
• Higher values (1.0-2.0): More creative, varied responses

Interactive Chat Selector

The tdx chats command provides an interactive interface for browsing and resuming chat sessions.

Usage

tdx chats [options]

Options

Option	Description
--last	Show the most recent chat session

Examples

# Open interactive chat selector
tdx chats

# Show the most recent chat session
tdx chats --last

The interactive selector allows you to:

• Browse all your chat sessions
• View chat history
• Resume conversations

Related Commands

• LLM Commands - Manage projects, agents, and chat history