Project Manager

BB's Project Manager helps you organize and manage your projects. Learn how to create new projects with multiple data sources, import existing ones, and manage project settings.

Overview

The Project Manager is your central hub for managing projects in BB. Each project can access multiple data sources including local directories, cloud platforms, and external services.

Data Sources

Filesystem

  • Local directories on your system
  • Automatically initialized as git repositories
  • Full read/write capabilities

Cloud Sources

  • Notion workspaces, MCP servers
  • Remote access to documents and data
  • Ideal for reference materials and collaboration

Key Features

  • Create new projects
  • Import existing projects
  • Switch between projects
  • Manage project settings
  • View project status

Creating Projects

Step-by-Step Guide

  1. Click the "Create New Project" button

    Found in the top-right of the Project Manager

  2. Enter project name and basic settings
    • Choose a descriptive name for your project
    • Configure any additional project-level settings
  3. Add your first data source
    • Select data source type (Filesystem, Notion, MCP servers)
    • For Filesystem: Choose an existing directory with your project files
    • For Notion: Enter API key and workspace details
    • For MCP: Configure server-specific settings
    • Set this as your primary data source
  4. Configure additional data sources (optional)
    • Add reference materials, documentation, or related resources
    • Each data source can have different capabilities (read, write, etc.)

Important Notes:

  • Every project needs at least one data source to function
  • Filesystem data sources must point to existing directories
  • Project names and data source configurations can be changed later
  • Performance: Consider the size and complexity of your data sources, as processing time increases with project scope

Managing Projects

Project Actions

Opening Projects

  • Click a project to open it
  • BB loads project data sources and settings
  • Start new conversation or continue existing ones

Project Settings

  • Click the settings icon for a project
  • Modify project name and general settings
  • Add, edit, or remove data sources
  • Set primary data source and priorities
  • View project details and statistics

Removing Projects

  • Click the remove icon
  • Only removes the project configuration from BB
  • Doesn't delete any actual files or data sources

Coming Soon:

Future updates will add support for cloud projects, enabling:

  • Direct GitHub repository integration
  • Cloud storage support
  • Team collaboration features

Best Practices

Project Organization

  • Use descriptive names that reflect the project's purpose
  • Group related projects logically in your project list
  • Regularly clean up unused projects
  • Document the purpose and scope of each project

Data Source Strategy

  • Set up your primary data source as your main working directory
  • Add reference materials and documentation as additional sources
  • Use read-only access for shared or reference materials
  • Consider which team members need access to which data sources

Performance Tips

  • Keep data sources focused and well-organized
  • Disable unused data sources to improve response times
  • Use .gitignore and similar files to exclude irrelevant content
  • Monitor the size and complexity of your data sources

Next Steps

Chat Interface

Learn how to use BB's chat interface to work with your projects.

Managing Conversations

Best practices for organizing conversations within projects.

Last updated: February 12, 2025