Skip to main content
Open a terminal tab to run shell commands in your workspace, such as 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 type exit. 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 as MY_API_TOKEN. To let one through, see Environment variables in kernels and shell commands.

Terminals in Qualia Cloud

A cloud terminal opens a bash 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.

Keyboard shortcuts

Qualia passes standard terminal shortcuts, such as Ctrl+C, straight to the shell. App shortcuts that work from a terminal include: