Project Manager
BB's Project Manager helps you organize and manage your projects. Learn how to create new projects, import existing ones, and manage project settings.
Overview
The Project Manager is your central hub for managing projects in BB. Each project represents a directory of files that BB can work with.
Project Types
Local Projects
- Any directory on your system
- No special requirements
- Perfect for simple projects
Git Projects
- Local directories with git repositories
- Enhanced version control awareness
- Ideal for development projects
Key Features
- Create new projects
- Import existing projects
- Switch between projects
- Manage project settings
- View project status
Creating Projects
Step-by-Step Guide
- Click the "Create New Project" button
Found in the top-right of the Project Manager
- Select project directory
- Use the file browser to select an existing directory
- BB won't create new directories
- Choose a directory that contains your project files
- Choose project type
- Local: Any directory of files
- Git: Directory with a git repository
- Configure project settings
- Project name is auto-filled from directory name
- Additional settings depend on project type
Important Notes:
- Projects must use existing directories
- Git detection is automatic for git repositories
- Project names can be changed later
- Side Note: While BB can handle projects with thousands of files, processing time increases with project size
Importing Projects
Using Import Projects
- Click the "Import Projects" button
Located near the "Create New Project" button
- Select directory to scan
- Choose a directory to scan for BB projects
- BB will scan the directory and its subdirectories
- Review discovered projects
- BB lists all projects discovered in the selected directory
- Each project shows its type and location
- Add projects to Project Manager
- Click the plus button to add individual projects
- Projects are immediately available after adding
Managing Projects
Project Actions
Opening Projects
- Click a project to open it
- BB loads project files and settings
- Start new conversation or continue existing ones
Project Settings
- Click the settings icon for a project
- Modify project name and type
- View project details and statistics
Removing Projects
- Click the remove icon
- Only removes from Project Manager
- Doesn't delete project files
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
- Keep related projects grouped in parent directories
- Use consistent naming conventions
- Regularly clean up unused projects
- Consider project size when organizing files
Project Types
- Use Git projects for active development work
- Use Local projects for simple file collections
- Consider future needs when choosing project type
Performance Tips
- Keep project directories focused and organized
- Remove unnecessary files to improve scanning speed
- Use .gitignore to exclude irrelevant files