Terminals in the side panel

A chat's side panel can hold your own terminal: a shell that opens in the chat's workspace folder, where you type commands yourself. It is yours alone: Oda does not type in it or read its output, and nothing from it joins the chat. The shells Oda keeps for its own commands are separate; see Persistent shells.

Open a terminal

  1. Open the side panel beside your chat and choose New terminal on its Start page (the card reads Run commands in the Session workspace). The shell you used last opens in a new tab, starting in the chat's workspace folder.
  2. To use a different shell, open the arrow beside New terminal (its name for screen readers is Choose shell) and pick one from the list. The list shows the shells found on this computer, with the one you used last marked; your pick opens right away.
  3. To open another terminal, use New tab in the panel and choose New terminal again. Each terminal gets its own tab.

While a terminal starts, its tab reads Reading terminal environment…, then Starting…, then Connecting….

Type, rename and resize

Messages the tab shows

Keep running and close

After a reload

Reloading reattaches each terminal tab to its shell and restores the screen. If the shell is gone, for example after you quit Oda, the tab reads This terminal no longer exists. Open a new terminal. with a New terminal button that replaces the tab in place. Nothing restarts the old shell on its own.

Your shell, not Oda's

Commands you type run with the rights of your own account on this computer, the same as a shell you open yourself. Oda never elevates them, and the chat's access mode, its approval prompts and Oda's sandbox do not apply to what you type; changing the access mode leaves the terminal as it is. Workspaces, files and permissions explains the modes.

Questions, answered

Where do I open a terminal?

The Start page of a chat's side panel shows a New terminal card; choosing it opens the shell you used last in the chat's workspace folder. For another one, use New tab in the panel.

Which shell will a new terminal use?

The one you used last. The arrow beside New terminal lists the shells found on this computer and marks your remembered one; choosing a shell opens it right away, and it is remembered for later terminals.

Why is there no terminal card in the panel?

The terminal comes from the Terminal tab switch under Settings > Developer > Advanced features. Switching it off removes the card and the tab at once; turn it on there. If your company manages the switch, ask your administrator. See Advanced features.

Does the terminal keep running when I collapse the panel or switch chats?

Yes. Collapsing the panel, switching tabs or chats, and floating or full-screen views leave the shell running, and a busy command is not stopped by a timer. The shell ends when you close its tab or quit Oda.

What happens to what is running when I close a terminal tab?

The tab disappears at once, and the app ends the shell and everything running in it, in the background. A closed terminal cannot be reopened, so open a new one when you need it. If the app cannot finish ending the processes, it remembers the request and tries again.

Where did my terminal go after I reloaded Oda?

Reloading reattaches each terminal tab to its shell and restores the screen. If the shell is gone, the tab reads This terminal no longer exists. Open a new terminal. and offers a New terminal button; nothing restarts the old shell on its own.

Why did a terminal close while I was not using it?

A terminal that no open tab holds is closed after about two hours without activity. Only time in which the shell is definitely idle counts, so a command that keeps working is not reclaimed. A shell whose activity Oda cannot read as idle, such as PowerShell or fish, is not closed by this timer and may stay open; close its tab when you are done with it. Your installation can change the period or switch the automatic closing off. When a closing cannot finish, nothing tells you and there is no retry control; the terminal stays as it was.

How many terminals can one chat keep?

Up to eight at a time, and exited terminals count toward the limit too. At the limit, a new terminal is refused with The terminal limit has been reached. Close unused terminals and try again. Exited terminals also count toward the limit. Close unused tabs to release them.

One of my terminals will not accept typing. Why?

Only one view of a terminal owns the keyboard at a time; the other reads This view is read-only. with a Take control button. Choose Take control in the view you are working in.

The tab says Disconnected. What should I do?

A connection hiccup stopped the screen updates. The shell keeps running and the screen stays as it was; choose Reconnect to carry on. Commands are not replayed or stopped by the reconnection.

Why does a large paste fail?

Typing is buffered up to 64 KiB at a time, and a very large paste can overflow the buffer. The tab shows a note reading The input buffer is full. Reconnect and try again. Choose Reconnect, then carry on.

Do the chat's access modes and approvals apply to my terminal?

No. Commands you type run with the rights of your own account on this computer, and they are not checked by the chat's access mode or by Oda's approval prompts. Nothing widens your rights for them. Workspaces, files and permissions explains the modes.