Chat Interface

BB's chat interface is your primary workspace for AI collaboration. Master its features to work efficiently with model configuration, conversation management, and interactive assistance.

Starting Your First Conversation

When you create a new conversation, BB presents a helpful starting interface with categorized task examples to inspire your objectives:

New Conversation Interface — BB's starting interface with categorized task examples and objective guidance

Task Categories

🔍 Research Tasks - Analysis, literature reviews, data exploration
✏️ Content Tasks - Writing, editing, content strategy
📊 Analysis Tasks - Data visualization, metrics analysis
💻 Development Tasks - Coding, refactoring, system design

💡 Pro Tip

Focus on what you want to achieve, not implementation details. BB works best when you describe your objectives clearly.

Chat Options & Model Configuration

Access the Chat Options dialog via the settings icon next to the Send button to configure models and advanced features for each conversation:

Key Configuration Options

Model Roles: Configure Orchestrator, Agent, and Admin models individually
Temperature: Control response creativity (0.0 = focused, 1.0 = creative)
Max Tokens: Limit response length per turn
Extended Thinking: Enable step-by-step reasoning for complex problems
Prompt Caching: Reduce token costs for repeated context

Learn about BB's role-based architecture →

Model Selection Interface

Model Selection Dropdown — Search and select from available models for each role

Model Selection Features:

Search models by name
View performance indicators (speed, cost, intelligence)
See context window sizes
Per-conversation customization

Conversation Management

BB provides powerful tools to organize and navigate your conversations efficiently:

Conversation Selector with Search — Search conversations and add favorites for quick access

Organization Features

Search: Find conversations by title or content
Favorites: Star important conversations for quick access
Auto-titles: BB generates descriptive titles from your objectives
Token tracking: See usage and turn counts at a glance
Timestamps: Track when conversations were last active

Best Practices:

Create focused conversations for specific objectives
Use favorites for ongoing projects
Start fresh conversations to avoid token buildup

Understanding Message History

Chat Message History with Expandable Entries — Message history showing different entry types with expand/collapse functionality

Message Types & Colors

Blue: Your messages and prompts

Green: BB's responses and thinking

Orange/Yellow: Tool operations and inputs

Purple: System operations and summaries

🔍 Expandable Entries - Explore Everything!

Every entry in the conversation history can be expanded or collapsed. While user prompts and AI responses are shown expanded by default, all other entries (tool operations, system messages, etc.) start collapsed to keep the interface clean.

What You Can Expand:

Tool input parameters and settings
Complete tool output and results
System operation details
File modification summaries
Error messages and diagnostics

How to Expand:

Click the entry header to expand/collapse
Space key when entry is focused
Arrow icons show expand/collapse state

💡 Pro Tip: Expanding tool entries helps you understand exactly what BB is doing and learn how different operations work. It's a great way to build your understanding of BB's capabilities!

File Suggestions & Autocomplete

BB provides intelligent file suggestions across all your data sources with advanced autocomplete featuring multi-datasource support and wildcard patterns:

File Autocomplete Interface — Multi-datasource file suggestions with path context and filtering

Trigger Methods

Tab Key: Press Tab anywhere in your message to show suggestions
Auto-trigger: Start typing a path to see matching files
Data source context: Files are grouped by data source

Advanced Patterns

*.ts - All TypeScript files
docs/**/* - All files in docs subdirectories
src/**/test* - Test files at any depth in src

Navigation & Selection:

Keyboard: ↑/↓ navigate • Enter selects • Escape closes

Best Practice: List files on separate lines for clarity

Prompt History & Reuse

Efficient Prompt Reuse

Access your recent prompts through the clock icon next to the message input. Perfect for iterating on ideas or reusing common instructions.

Recent Prompt History Dropdown — Quick access to recent prompts for reuse and iteration

Key Features

Recent prompts: Last several messages you've sent
Quick selection: Click to reuse or modify previous prompts
Time-saving: Avoid retyping similar requests

Use Cases

Great for refining prompts, trying variations, or building on previous successful interactions.

Model Information & Context Monitoring

Click the "Model Info" button in the header to see detailed information about your current model configuration and context usage:

Detailed Model Information Panel — Comprehensive model stats including context usage, caching impact, and configuration details

Context Tracking

Current token usage vs. limit
Percentage of context window used
Real-time usage monitoring

Caching Benefits

Prompt caching status
Token savings from cache
Cost reduction impact

Configuration

Current model details
Temperature and settings
Extended thinking status

Keyboard Shortcuts & Productivity Tips

Message Controls

Send messageCmd/Ctrl + Enter

New line in messageEnter

File suggestionsTab

Clear messageEsc

Message Navigation

Expand/collapse entrySpace

Navigate entries

↑↓

Navigate file suggestions

↑↓

Token Management & Cost Optimization

Context Usage Monitoring

The progress bar shows how much of the model's context window is being used. Monitor this to understand when conversations are approaching context limits.

Context Usage Progress Bar — Real-time context window usage tracking with percentage indicator

Color Indicators

Green = Normal usage (under 50%)

Yellow = Moderate usage (50%+ context used)

Red = High usage (90%+ context used)

Tiered Pricing Models

For models with tiered pricing, tick marks show where price tiers change, and the label color shifts toward red as you progress through higher cost tiers.

Token Management Tips

Monitor the progress bar in your input area
Keep conversations focused on single objectives
Start fresh conversations to reset context
Remove files when no longer needed

Cost Optimization

Enable prompt caching for repeated context
Use conversation summaries for long sessions
Choose appropriate models for different tasks
Leverage BB's auto top-up for budget control

Pro Tip: The Model Info panel shows detailed caching benefits and context usage. Use it to understand your token efficiency and optimize your workflow.