git, pip install, or a training script. On the desktop app, the terminal runs on your machine. In Qualia Cloud, it runs in your workspace’s cloud environment.
In cloud workspaces, only the workspace owner can open a terminal. Editors can ask their agents to run shell commands instead.
Open a terminal
- Press Ctrl+`.
- Choose File > New Terminal.
- Click + in the terminal panel.
Work with several terminals
Each terminal is its own tab. You can drag terminal tabs between panes in split view. To close a terminal, click the X on its tab or typeexit.
When you quit and reopen the desktop app, your terminal tabs come back with fresh shells. Each shell starts over, so environment variables and the current directory reset.
Local terminals and notebooks
A desktop terminal sees the same workspace files as your local notebooks. Files you create in the terminal show up in notebooks right away. The terminal inherits your environment, except that Qualia withholds variables with credential-like names, such asMY_API_TOKEN. To let one through, see Environment variables in kernels and shell commands.
Terminals in Qualia Cloud
A cloud terminal opens abash session in your workspace’s cloud environment. You don’t need to start a notebook first.
The terminal and your notebook kernels share workspace files, but each has its own processes and installed packages. For example, a package you pip install in the terminal isn’t available to a running notebook kernel.
- The terminal starts in your workspace folder, and files a command creates show up in Files.
- Closing the tab ends the session, and so does the environment shutting down when idle.
- If your connection drops, Qualia reconnects you to the same shell while the environment is still running.
- If the terminal asks you to restart the environment, wait for running work to finish first. Restarting keeps your files but stops running kernels.
Choose a shell
On the desktop app, set Settings > Environments > Terminal > Terminal shell to the shell you want, such as/bin/zsh or /bin/bash. The setting applies to new terminals only.
If you leave it empty, Qualia uses your SHELL environment variable on macOS and Linux, and PowerShell on Windows. Cloud terminals always run bash.

