File Management

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

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 collaborations
  • BB can read and modify project files
  • File changes are tracked in collaboration

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 collaboration
  • Changes are logged for reference
  • You can review changes before applying
  • BB won't delete files without confirmation

Best Practices

File Management

  • Keep collaborations 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 collaborations
  • Use specific paths instead of broad wildcards
  • Remove unused files to reduce token usage
  • Start new collaborations for different file sets

Next Steps

Managing Collaborations

Learn how to effectively manage collaborations and file context.

Chat Interface

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

Last updated: February 12, 2025