Workspaces

Workspaces are the core of Calvin. Each workspace is a fully provisioned development environment where AI agents build, modify, and maintain your projects. A workspace combines a code editor, file system, browser preview, version control, and a conversational interface — all in one place.

Every workspace is tied to a specific technology stack and comes with agents trained for that stack. When you create a workspace from a template, Calvin automatically assigns the right agents and configures the environment accordingly.

Calvin offers workspace templates for a wide range of eCommerce platforms and technologies. For eCommerce platforms, you can choose from Web Development with Node.js and Next.js, VTEX IO Theme development, VTEX IO Apps development, VTEX Admin Development, VTEX FastStore Development, Magento Development, Shopify Development, WooCommerce Development, and Medusa Development. For general development, templates are available for Ruby on Rails, Java Spring Boot, Python with FastAPI, and Mobile App Development. Specialized templates include UI/UX Design, n8n Workflow Automation, Data Science, and Web QA.

You can also start from scratch with a blank workspace and assign custom agents.

Each template pre-assigns agents from the appropriate team. For example, a Web Development workspace includes a Full Stack Developer and an Analyst, while a Magento workspace includes a Magento Developer and an Analyst.

The workspace interface is divided into three main panels. On the left is the chat panel where you interact with Calvin's agents through natural language. Chats are listed by name and status, and you can switch between multiple chats within the same workspace. In the center is the code panel with a file explorer on the left side and a code editor on the right. You can browse the project file tree, open and edit files directly, and view an agents.md file that contains agent configuration. The icons above the file explorer provide access to different views: the file tree, documents, Git controls (View Tree, Tools, and Take over), and workspace configuration settings. On the right is the browser preview panel that renders your application in real time, so you can see changes as the agent makes them.

The top toolbar provides access to several important features. The Connectors button opens a panel where you can add MCP integrations to extend the workspace. The Blocks button opens the Blocks Marketplace where you can install building blocks (databases, AI SDKs, error tracking, and more) and skills (community knowledge packs). The version selector shows all saved versions of your workspace and lets you switch between them. The Deploy button initiates the deployment flow to ship your project to production.

The three-dot menu at the top right of the workspace provides additional options including Open App (to view your deployed application), Traffic monitoring, Web Analytics, and Web Performance metrics.

Workspace configuration is accessible through the settings icon in the file explorer toolbar. This is where you configure source code management, choosing between Calvin's Internal Git (which creates and manages a private repository for you), or connecting your own repository on GitHub, Bitbucket, or GitLab. You can set the target branch that feature branches merge into (such as main, develop, or staging), associate documentation with the project, and configure the chat closing action — either Merge and Push (which automatically merges changes to the target branch when a chat is completed) or Create Pull Request (which opens a PR for your team to review before merging).