mastra-workspace

name	mastra-workspace
description	Mastra Workspace development - filesystem providers, sandbox execution, skills system, search/indexing, and tool configuration

Mastra Workspace Development

Comprehensive guide for Mastra workspaces. Covers filesystem providers (LocalFilesystem, S3Filesystem, GCSFilesystem), sandbox execution (LocalSandbox, E2BSandbox), mounts for multi-provider composition, skills system (Agent Skills spec), BM25/vector/hybrid search, tool configuration with WORKSPACE_TOOLS, and containment security.

Usage

/mastra-workspace

Provides context for:

• Workspace class from @mastra/core/workspace
• filesystem vs mounts (mutually exclusive)
• LocalFilesystem({ basePath, contained, readOnly, allowedPaths })
• LocalSandbox({ workingDirectory }) and E2BSandbox({ id })
• WORKSPACE_TOOLS for per-tool config (enabled, requireApproval, requireReadBeforeWrite)
• Skills with SKILL.md (Agent Skills spec)
• Search: workspace.search(), workspace.index(), BM25/vector/hybrid
• Global workspace via Mastra({ workspace }) or agent-scoped