Workspace tools

The Workspace brings the tools used to work on a product into the same sandbox.

Agent and project context

Describe the outcome you want in chat. The agent can inspect the project, edit files, run commands, use the browser, and report what changed. Attach files or add project context when the task needs information that is not already in the repository.

Files and editor

Use the file explorer to open, create, rename, upload, and remove project files. Editor changes are written to the sandbox filesystem and are immediately visible to running processes.

Terminal

Open a terminal for Artisan commands, test suites, scripts, and process inspection. Commands run inside the sandbox rather than on your computer.

Keep a long-running application or worker in its own terminal or configured service so its output remains easy to inspect.

Composer

Ask the agent to manage Composer packages or use the terminal when you want to run the command directly.

Dependency changes update the project files in the sandbox. Commit composer.json and composer.lock when those changes belong in the product.

Environment settings

Environment settings configure values used by the project without placing them directly in source files. Use them for project configuration and credentials.

Never paste production secrets into source-controlled files or share them in a public sandbox.

Mail and preview

The mail tool captures messages sent through the sandbox mail configuration so you can inspect recipients, content, and attachments without sending real email.

Preview opens the running product in the browser. If it is unavailable, inspect the process and its logs before changing preview settings.