Skip to content

Terminals

A terminal runs a shell in the worktree of the task, or in the folder of the workspace session. You can also use the terminals from the mobile app.

Open a terminal

Do one of these:

  • At the top right, select Show bottom panel. An empty bottom panel opens a new terminal.
  • At the end of the panel tabs, select +, then Terminal.
  • Select a repository action in the top bar of the session. It runs in a new terminal in the bottom panel.

A task or a workspace session can have at most 8 terminals.

Screen readers cannot read the text of a terminal.

Open a terminal, run a command and the default action, then drag a terminal to the right panel.

When a terminal stops

WhenWhat happens to the terminal
You open another page, or reload the pageIt keeps running. When you come back, it shows again with its output.
You close its tabIt stops. If a command still runs, OpenDucktor asks first.
Its shell exitsIts output stays, with the exit code under it.
You close, reset, or delete the task, archive the workspace session, or OpenDucktor removes the worktree of a merged taskIt stops.
OpenDucktor stopsIt stops.

Restart a command

With zsh, the tab of a running command shows Restart command. It sends Ctrl+C to the command, then runs it again in the same terminal.

Setup actions

The actions that run when OpenDucktor creates a worktree also run in terminals. Their tabs do not open the bottom panel. To see their output, select Show bottom panel. See Run setup commands.

Next

On this page