Customize your app
Agent
Use the terminal

Use the terminal

Run commands in your system's workspace from the Agent Module, next to the agent and your files.

Before you start

  • Open your system and select Agent in the top bar. See Open and set up the Agent Module.
  • The terminal runs on your system's real workspace. Commands that delete or change files take effect straight away, so be careful.

Steps

Find the terminal

The terminal is below the Code panel, on the right of the Agent workspace. Its tab is called bash. It opens in your system's folder, ready for a command.

Run a command

Click in the terminal, type a command and press Enter. The output appears right below it. For example:

CommandWhat it does
pwdShows which folder you are in (your system's workspace)
lsLists the files and folders there: backend, frontend, docs, CLAUDE.md and so on
ls backend/endpointsLooks inside a folder, here the backend's endpoints
clearClears the screen

Use the terminal to check files, run scripts or look at logs while you work with the agent.

Open another terminal

Select + next to the terminal tabs to open another terminal in a new tab, for example to keep one command running while you use another.

Close a tab

Select × on a tab to close it when you are done.

Screenshots

Step 1: Find the terminal

The terminal below the Code panel in the Agent workspace

Step 2: Run a command

pwd showing the workspace folder ls listing the files and folders ls backend/endpoints listing the endpoint folders

Step 3: Open another terminal

The + button highlighted next to the bash tab A second terminal tab opening

Step 4: Close a tab

The close button highlighted on the second terminal tab

Watch how

⚠️

The terminal has full access to your system's files. Don't delete or edit files there unless you know what they do. To change your system safely, ask the agent and check its plan first.

Next steps