Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bugster.dev/llms.txt

Use this file to discover all available pages before exploring further.

Team collaboration requires authentication and generated tests to share.

​
Command Usage

​
bugster sync

Synchronize your local test specifications with the remote Bugster platform for team collaboration. 
bugster sync [OPTIONS]
Options:
  • --pull - Download test specifications from remote without uploading local changes
  • --push - Upload local test specifications to remote without downloading changes
  • --branch BRANCH - Synchronize with a specific branch instead of the default
  • --clean-remote - Delete remote test specifications that don’t exist locally
  • --dry-run - Preview sync operations without making actual changes
  • --prefer CHOICE - Prefer ‘local’ or ‘remote’ when resolving conflicts

​
Examples

# Full bidirectional sync
bugster sync

# Sync with specific branch
bugster sync --branch feature/new-ui

# Only download specs from remote
bugster sync --pull

# Preview upload without making changes
bugster sync --push --dry-run

# Resolve conflicts preferring local versions
bugster sync --prefer local

# Clean up remote specs not present locally
bugster sync --clean-remote

​
Team Workflows

​
Getting Started on a Project

# 1. Authenticate with Bugster
bugster auth

# 2. Initialize project
bugster init

# 3. Pull existing team tests
bugster sync --pull

# 4. Run tests to verify setup
bugster run

​
Daily Development Workflow

# 1. Pull latest team changes
bugster sync --pull

# 2. Make code changes
# [Your development work]

# 3. Update tests for your changes
bugster update

# 4. Run tests locally
bugster run

# 5. Push updated tests
bugster sync --push

​
Feature Branch Workflow

# 1. Create feature branch locally
git checkout -b feature/user-dashboard

# 2. Pull base tests
bugster sync --pull --branch main

# 3. Work on feature and update tests
bugster update
bugster run

# 4. Push feature-specific tests
bugster sync --push --branch feature/user-dashboard

​
Common Issues

Sync Failures:
  • Check your internet connection
  • Verify authentication: bugster auth
  • Try again after a few minutes
Merge Conflicts:
  • Pull latest changes first: bugster sync --pull
  • Use --prefer local or --prefer remote for automatic resolution

​
Next Steps

Run Tests

Execute your synchronized test suite

Test Maintenance

Keep shared tests updated with code changes