Workspace Module

Under Development - This feature is not yet available in the current release.

The Workspace module provides multi-repository workspace management with team collaboration, branch hosting, and integrated database services.

Overview

Workspaces allow you to: - Group multiple repositories under a single project - Invite team members with role-based permissions - Deploy branches to live URLs with one click - Manage databases with integrated PostgreSQL and GraphQL - Use the Workspace Agent (Claude Mode) for AI-assisted development

Creating a Workspace

1. Click on the Workspaces tab in the module bar
2. Click Create Workspace in the left panel
3. Enter a workspace name and optional description
4. Optionally add an avatar URL for the workspace icon
5. Click Create

You are automatically assigned as the owner of workspaces you create.

Workspace Navigation

Left Panel

• Workspace Selector - Switch between your workspaces
• Linked Repositories - View all repos in the current workspace
• Plans (Claude Mode) - Access saved execution plans

Right Panel

• Members List - View workspace members and their roles
• Agent Terminals (Claude Mode) - Monitor AI agent sessions

Main Area

• Overview Tab - Workspace stats and quick actions
• Hosting Tab - View all deployed instances

Linking Repositories

To add a repository to your workspace:

1. Click Link Repository in the workspace overview
2. Select a repository from the dropdown (shows your GitHub/GitLab/Gitea repos)
3. The repository is now part of your workspace

Linked repositories are automatically cloned to your local environment when you select the workspace.

Repository Dashboard

Click on any linked repository to open its dashboard:

Member Management

Adding Members

1. Click Add Member in the members list
2. Search for a user by their GitHub username or display name
3. Select a role for the new member
4. Click Add

Member Roles

Removing Members

Owners and admins can remove members by clicking the remove button next to their name in the members list.

Branch Hosting

Deploy any branch to a live URL with automatic builds.

Enabling Hosting

1. Open the repository dashboard
2. Go to the Hosting tab
3. Click Enable Hosting
4. Configure your deployment settings:
   • Subdomain - Your app will be available at subdomain-branch.teamide.dev
   • Framework - Select from presets or configure custom build

Framework Presets

Adding Branches

1. Click Add Branch in the hosting configuration
2. Select the branch to deploy
3. Configure branch-specific settings if needed
4. Click Deploy

Branch Options

Each deployed branch can have: - Environment Variables - Secure key-value pairs for build and runtime - Custom Domain - Use your own domain with DNS verification - Password Protection - Restrict access with a password - Auto-deploy - Automatically redeploy when the branch is updated

Deployment Status

Viewing Build Logs

Click the Logs button on any branch to view the build output and diagnose issues.

Database Integration (Nhost)

Each repository can have an integrated database with: - PostgreSQL database - Hasura GraphQL API - Authentication service - Admin dashboard

Creating a Database Instance

1. Open the repository dashboard
2. Go to the Database tab
3. Click Create Instance
4. Wait for provisioning to complete

Database Access

Once created, you’ll have access to: - GraphQL Console - Query and mutate data - Auth Dashboard - Manage users and authentication - Hasura Console - Database administration

Use the SSO buttons to open dashboards without additional login.

Standard Mode vs Claude Mode

Toggle between modes using the switch in the workspace navigation.

Standard Mode

The default workspace experience for: - Viewing workspace overview and stats - Managing members and repositories - Configuring hosting deployments - Accessing database dashboards

Claude Mode (Workspace Agent)

An AI-assisted development mode that provides:

Plan Mode

Create YAML execution plans that are reviewed before running: 1. Write or edit a plan in the plan editor 2. Review the planned actions 3. Approve and execute

Execute Mode

Run commands directly with the AI agent (requires explicit approval for dangerous operations).

Agent Terminals

• Main Terminal - Orchestrates work across repositories
• Repository Terminals - Dedicated terminal per repository being modified

Session status indicators: - Idle - Ready for commands - Working - Currently executing - Complete - Task finished successfully - Error - Execution failed - Blocked - Waiting for user input

Sharing Repositories

Share individual repositories with users outside your workspace:

1. Go to the repository settings
2. Click Share Repository
3. Search for a user and select permission level:
   • View - Read-only access
   • Edit - Can make changes
   • Admin - Full repository access

View shared repositories in the Shared with Me section of your workspace list.

Workspace Settings

Access workspace settings by clicking the gear icon in the workspace navigation.

General Settings

• Workspace name
• Description
• Avatar URL

Danger Zone

• Delete Workspace - Permanently removes the workspace and unlinks all repositories (Owner only)

Requirements

• GitHub Account - Required to create workspaces and link repositories
• Pro Subscription - Required for hosting features
• TeamIDE Cloud Account - Workspace data is stored in TeamIDE cloud

Related

• Authentication - Setting up GitHub accounts
• Settings - TeamIDE subscription settings
• Code Module - Working with repository files

Changelog