File Management

Learn how BB works with your project files and how to effectively manage files in your conversations.

Overview

BB can access and work with any files in your project directory. Understanding how BB handles files will help you work more effectively.

Key Concepts

  • All paths are relative to project root
  • Files must be explicitly added to conversations
  • BB can read and modify project files
  • File changes are tracked in conversation

Common Operations

  • Reading file contents
  • Modifying existing files
  • Creating new files
  • Moving and renaming files

File Suggestions

Using Auto-Complete

BB provides intelligent file suggestions to help you quickly reference project files:

Trigger Methods

  • Type / to show suggestions
  • Press Tab at any point
  • Continue typing to filter

Navigation

  • ↑/↓ to move through suggestions
  • Enter to select
  • Escape to close suggestions

Using Wildcards

Use wildcards to match multiple files:

  • *.ts - All TypeScript files
  • test/* - All files in test directory
  • src/**/*.tsx - All TSX files in src tree

Pro Tip: When referencing multiple files, list each one on a new line for better readability.

File Operations

Available Operations

Reading Files

  • Request specific files
  • Search file contents
  • Analyze code patterns
  • Review changes

Modifying Files

  • Edit file contents
  • Create new files
  • Move or rename files
  • Apply patches

Important Notes:

  • BB tracks all file changes in the conversation
  • Changes are logged for reference
  • You can review changes before applying
  • BB won't delete files without confirmation

Best Practices

File Management

  • Keep conversations focused on relevant files
  • Remove files when no longer needed
  • Use wildcards carefully to avoid loading too many files
  • Consider token costs when adding large files

Project Organization

  • Use clear, consistent file naming
  • Organize files logically in directories
  • Use .gitignore to exclude irrelevant files
  • Keep project structure clean and maintainable

Performance Tips

  • Add only necessary files to conversations
  • Use specific paths instead of broad wildcards
  • Remove unused files to reduce token usage
  • Start new conversations for different file sets

Next Steps

Managing Conversations

Learn how to effectively manage conversations and file context.

Chat Interface

Master BB's chat interface for working with files and projects.