Workflow 003: Team Collaboration

Fresh

Field	Value
Workflow ID	WF-003
Version	1.0
Status	Active

Overview

Collaborate with your team using shared sessions, Warp Drive, and centralized agent configuration.

Workflow Steps

1. Create or Join a Team

Navigate to Settings > Teams in Warp to create or join a team.

2. Share Agent Sessions

# Share with yourself (for cross-device access)
oz agent run --share --prompt "fix the compiler error"

# Share with specific users (view-only)
oz agent run --share user@example.com --prompt "fix the bug"

# Share with specific users (edit access)
oz agent run --share user@example.com:edit --prompt "review this PR"

# Share with entire team (view-only)
oz agent run --share team --prompt "deploy to staging"

# Share with entire team (edit access)
oz agent run --share team:edit --prompt "investigate the outage"

3. Share Knowledge via Warp Drive

Warp Drive centralizes team knowledge:

• Workflows - Saved parameterized commands
• Prompts - Reusable agent prompts
• Rules - Shared coding standards
• MCP Servers - Connected tools

4. Use Saved Prompts

Save effective prompts in Warp Drive and reuse them:

# Get the prompt ID from its Warp Drive sharing link
# https://staging.warp.dev/drive/prompt/Fix-compiler-error-sgNpbUgDkmp2IImUVDc8kR
# ID: sgNpbUgDkmp2IImUVDc8kR

oz agent run --saved-prompt sgNpbUgDkmp2IImUVDc8kR

5. Centralize Configuration

For consistent behavior across the team:

• Project Rules - Commit AGENTS.md to repo (everyone gets the same rules)
• Skills - Commit skills to .agents/skills/ in repo
• MCP Servers - Configure once, available to all team members

6. Manage Cloud Agent Activity

Use the Oz web app to:

• View all agent runs across the team
• Filter by status, name, or trigger
• Inspect session transcripts
• Track credit usage

Session Sharing Permissions

Flag	Access Level
--share	Self only
--share user@email.com	User: view-only
--share user@email.com:edit	User: read/write
--share team	Team: view-only
--share team:edit	Team: read/write

Best Practices

• Commit AGENTS.md and skills to version control
• Use descriptive --name flags for cloud runs
• Share sessions for code reviews and debugging
• Centralize MCP server configuration
• Use saved prompts for repeatable workflows

See Also

• SOP 003: Rules Configuration
• SOP 004: Cloud Agents Setup
• Workflow 002: Cloud Agent Deployment