Nora
docs
Sessions

Terminals

Open tracked shell sessions in the repo root or any worktree, including script-backed terminals for common project actions.

What terminal sessions do

A terminal session is a PTY-backed shell managed by Nora without an agent wrapper around it. The app tracks the shell choice, target checkout, command label, branch, and workspace path so terminal work stays visible alongside agent activity.

How to open a terminal

Use the open terminal flow to choose a shell and attach the terminal either to the repo root or to an existing worktree. This is the right tool for running manual commands, inspecting a checkout directly, or debugging outside the agent loop.

How command presets work

Terminal presets let you save reusable launches instead of rebuilding the same shell commands every time. A preset can define the shell, working directory, and one or more commands, and Nora runs those commands in order as a single launch flow. Use presets for things like booting a local stack, opening a test watcher, or starting a dev server with the right directory and shell already selected.

Global presets and workspace presets

You can keep presets globally in your app settings or store them only for a specific workspace. Global presets are useful for routines you use across many projects. Workspace presets are better when the commands are project-specific and should only appear inside that one repository.

How package scripts fit in

Nora can also detect package scripts in the focused workspace and turn them into ready-to-run terminal actions. That gives you a lightweight launch menu for common project commands without having to build a preset first. If the workspace has no detected package scripts, the script launcher simply stays empty and you can still rely on manual terminals or saved presets.

How terminal sessions surface local apps

When a terminal launches something that exposes a local port or URL, Nora can detect that and attach it to the session. You may see the detected port as a badge in the terminal header, and if the full local URL is known you can open the app directly from the session or let Nora open it automatically in the internal browser if that setting is enabled.