Skip to main content
The Terminals panel is for plain terminal sessions. These are shells you run yourself, not coding agents. Terminal Agents do not live here. They live in Agents. For the full distinction, see Terminal Agents VS Terminals.

​
Create A Terminal

Click New terminal (the + in the panel header). The picker has two sections:
  • Host: the machine the shell runs on.
  • Workspaces: the folder the shell starts in. It starts on the Task’s primary folder. Use “Search repo, branch, or path…” to find another.
Click Launch, or press Cmd + Enter / Ctrl + Enter. If the Task has no folders, the terminal starts in the Task’s own folder on that host, ~/.traycer/epics/<task-id>. The shell program comes from Shell settings; you can’t pass a command when you launch.

​
Terminal Rows

  • Click a row to open the terminal as a tab.
  • Drag a row onto the canvas to open it there: onto a tab strip to add it as a tab, or onto the edge of a group to split that group.
  • Double-click a row to rename it. Press Enter to save or Esc to cancel.
  • Hover a row and click ⋯, or right-click it, for:
Closing a terminal’s tab does not end the shell; the terminal stays in the panel. When a shell exits on its own, the terminal leaves the list.

​
Terminal Names

A terminal’s name, in the panel and on its tab, is the first of these that applies:
  1. The custom name you gave it.
  2. The folder and the program running in the foreground, for example api · vim.
  3. The folder and “New Terminal”, when nothing is running in the foreground.
  4. “New Terminal”.
The folder is the last part of the shell’s current directory, so the name follows cd.

​
Find In A Terminal

The panel has no search. To search inside a terminal, including its scrollback, open the terminal and press Cmd + F on macOS or Ctrl + Alt + F on Windows and Linux. See Find In A Tile.

​
What Terminals Are For

Use terminal sessions for package scripts, tests, logs, local debugging, and one-off commands. Plain terminals do not receive Traycer’s agent prompt, skills, artifact instructions, or agent-to-agent communication tools. Terminals can also live outside a Task, in the start page panel. Cross-host terminal behavior is covered in Hosts.