Workspace Management Guide

Complete guide to workspaces, projects, and team collaboration

Overview

Workspaces in Lovelace organize your projects, provide context for AI interactions, and manage team collaboration. This guide covers workspace operations, project integration, and team workflows.

Understanding Workspaces

What are Workspaces?

Workspaces are organizational units that:

Group related projects and resources
Provide context for AI chat and analysis
Enable team collaboration and sharing
Sync data across devices and team members
Manage permissions and access control

Workspace vs Project

Concept	Purpose	Scope
Workspace	Organizational container	Multiple projects, team collaboration
Project	Individual codebase or application	Single repository or application

Workspace Operations

List Workspaces

bash

# List all available workspaces
ada workspace list

# List with detailed information
ada workspace list --detailed

# List only your workspaces
ada workspace list --mine

Switch Workspaces

bash

# Switch to a workspace
ada workspace switch my-project

# Switch with confirmation
ada workspace switch team-workspace --confirm

# Switch and sync immediately
ada workspace switch production --sync

Create Workspaces

bash

# Create new workspace
ada workspace create my-new-project

# Create with description
ada workspace create mobile-app --description "React Native mobile application"

# Create private workspace
ada workspace create private-research --private

Workspace Information

bash

# Show current workspace
ada workspace current

# Show workspace details
ada workspace info my-project

# Show workspace activity
ada workspace activity

# Show workspace members
ada workspace members

Project Integration

Initialize Project

bash

# Navigate to your project directory
cd /path/to/your/project

# Initialize Lovelace in project
ada workspace init

# Initialize with specific workspace
ada workspace init --workspace my-workspace

What happens during initialization:

Creates .lovelace/ directory in project root
Generates project configuration file
Analyzes project structure and dependencies
Connects project to workspace

Project Configuration

File: .lovelace/config.json

json

{
  "project": {
    "name": "my-application",
    "workspace": "development-team",
    "type": "web-application",
    "framework": "react-nextjs"
  },
  "analysis": {
    "include_patterns": ["src/**/*", "components/**/*"],
    "exclude_patterns": ["node_modules/**", "build/**"],
    "language": "typescript"
  },
  "integrations": {
    "git": true,
    "package_manager": "npm",
    "ci_cd": "github-actions"
  }
}

Project Status

bash

# Check project integration status
ada workspace status

# Validate project configuration
ada workspace validate

# Show project analysis summary
ada workspace analyze --summary

Synchronization

Manual Sync

bash

# Sync current workspace
ada workspace sync

# Sync specific workspace
ada workspace sync my-project

# Force complete sync
ada workspace sync --force

# Sync with conflict resolution
ada workspace sync --resolve-conflicts

Auto Sync

bash

# Enable auto-sync for workspace
lovelace config set workspace.auto_sync true

# Set sync interval (minutes)
lovelace config set workspace.sync_interval 15

# Disable auto-sync
lovelace config set workspace.auto_sync false

Sync Status

bash

# Check sync status
ada workspace sync-status

# View sync history
ada workspace sync-history

# Check for conflicts
ada workspace conflicts

Team Collaboration

Member Management

bash

# Invite team member
ada workspace invite user@example.com

# Invite with specific role
ada workspace invite developer@company.com --role developer

# List workspace members
ada workspace members

# Remove member
ada workspace remove-member user@example.com

Roles and Permissions

Role	Permissions
Owner	Full access, member management, workspace settings
Admin	Most access, member management, limited settings
Developer	Read/write access to projects, limited admin functions
Viewer	Read-only access to projects and conversations

bash

# Change member role
ada workspace set-role user@example.com admin

# View member permissions
ada workspace permissions user@example.com

Sharing & Collaboration

bash

# Share workspace link
ada workspace share

# Generate invite link
ada workspace invite-link --role developer

# Export workspace data
ada workspace export --format json

# Import shared workspace
ada workspace import shared-workspace.json

Backup & Restore

Backup Workspace

bash

# Backup current workspace
ada workspace backup

# Backup to specific location
ada workspace backup --output ./backups/

# Backup with compression
ada workspace backup --compress

# Scheduled backup
ada workspace backup --schedule daily

Restore Workspace

bash

# List available backups
ada workspace backups

# Restore from backup
ada workspace restore backup-2024-01-15.tar.gz

# Restore specific components
ada workspace restore --projects-only backup.tar.gz

Backup Configuration

bash

# Configure backup settings
lovelace config set backup.auto_backup true
lovelace config set backup.retention_days 30
lovelace config set backup.location ~/.lovelace/backups/

Advanced Workspace Features

Workspace Templates

bash

# List available templates
ada workspace templates

# Create from template
ada workspace create web-app --template react-typescript

# Create custom template
ada workspace template create my-template

Environment Management

bash

# List workspace environments
ada workspace environments

# Switch environment
ada workspace env production

# Create new environment
ada workspace env create staging

Workspace Settings

bash

# View workspace settings
ada workspace settings

# Update workspace settings
ada workspace settings set description "New description"
ada workspace settings set privacy private

# Configure AI settings
ada workspace settings ai --provider anthropic
ada workspace settings ai --model claude-sonnet-4-6

Integration Patterns

Git Integration

bash

# Connect git repository
ada workspace git connect origin

# Sync with git branches
ada workspace git sync-branches

# Auto-link commits to conversations
lovelace config set git.auto_link_commits true

CI/CD Integration

bash

# Connect CI/CD pipeline
ada workspace cicd connect github-actions

# View pipeline status
ada workspace cicd status

# Trigger workspace sync on deployment
ada workspace cicd hook deploy

External Tools

bash

# Connect issue tracker
ada workspace connect linear
ada workspace connect jira

# Connect documentation
ada workspace connect notion
ada workspace connect confluence

# Connect monitoring
ada workspace connect datadog
ada workspace connect newrelic

Troubleshooting

Sync Issues

Sync Conflicts

bash

# Check for conflicts
ada workspace conflicts

# Resolve conflicts manually
ada workspace resolve-conflicts

# Force resolution (use local)
ada workspace sync --force-local

# Force resolution (use remote)
ada workspace sync --force-remote

Sync Failures

bash

# Check sync logs
ada workspace sync-logs

# Retry failed sync
ada workspace sync --retry

# Reset sync state
ada workspace sync --reset

Permission Issues

Access Denied

bash

# Check your permissions
ada workspace permissions

# Request access from workspace owner
ada workspace request-access

# Switch to accessible workspace
ada workspace list --accessible

Performance Issues

Large Workspaces

bash

# Optimize workspace
ada workspace optimize

# Clean up old data
ada workspace cleanup

# Archive inactive projects
ada workspace archive-inactive

Slow Sync

bash

# Use incremental sync
ada workspace sync --incremental

# Exclude large files
lovelace config set sync.exclude_patterns "*.log,*.tmp"

# Limit sync bandwidth
lovelace config set sync.bandwidth_limit 1MB

Best Practices

Workspace Organization

Use descriptive names - mobile-app-ios vs project1
Separate by team/purpose - Different workspaces for different teams
Keep projects related - Group related projects in same workspace
Regular cleanup - Archive completed projects

Collaboration

Set clear roles - Assign appropriate permissions to team members
Regular sync - Keep workspace data synchronized
Document conventions - Establish naming and organization conventions
Use templates - Create templates for common project types

Performance

Exclude unnecessary files - Configure sync patterns appropriately
Regular maintenance - Clean up old data and optimize workspace
Monitor usage - Keep track of workspace size and activity
Use environments - Separate development, staging, and production

Next Steps:

AI Chat & Analysis - Start using AI in your workspace
Agent Execution - Set up agent workers
Editor Integration - Connect your editor to workspace