All applets
Development

Terminal Session

GPU-accelerated terminal with PTY support. Run shell commands, scripts, and dev tools.

Features

  • GPU-rendered terminal with crisp text
  • Multiple terminal tabs per session
  • Command history and session replay
  • Powerline/Nerd Font support
On this page

The Terminal resource gives you a full shell session directly inside RightPlace. Each stage can have its own terminal tied to the project’s working directory, so you can run commands without leaving the app.

Features

  • GPU-accelerated native terminal rendering on macOS
  • Persistent sessions that survive tab switches and app restarts
  • Automatic working directory tracking (the terminal stays in sync with your project path)
  • Prompt panel and command history at the bottom of the terminal
  • SSH connections for remote server access with password or key-based authentication

Terminal session open in a Dev stage, showing the shell prompt at the project working directory with Prompt and History tabs at the bottom

Adding a Terminal Session

To add a terminal to a stage, open the Add Resource dialog and select Terminal Session under the Development category.

Add Resource dialog showing Terminal Session under the Development category

The creation form lets you configure:

  • Name: a label for the terminal (e.g. “Dev Server”)
  • Environment: the environment tag (Development, Staging, Production, etc.)
  • Working Directory: the starting directory for the shell. Defaults to the project directory. Leave empty to use your home directory.
  • Input History Limit (MB): max size for captured input history (default 2 MB)
  • Output History Limit (MB): max size for captured output history (default 5 MB)

Terminal Session creation form with name, environment, working directory, and history limit fields

Using the Terminal

Once created, the terminal opens a shell session in the configured working directory. The breadcrumb at the top shows the project, stage, and session type (e.g. wp-test-site / Dev (local) Terminal Session DEVELOPMENT).

The top-right tabs let you switch between:

  • Terminal: the active shell session
  • Agent: AI assistant context
  • Settings: terminal and connection configuration

Prompt & History

At the bottom of the terminal, a collapsible panel provides two tabs:

  • Prompt: a text input for composing commands before sending them to the terminal. It keeps a history of up to 200 commands that you can click to re-use.
  • History: a full log of the session with timestamps, showing both input and output.

The panel is resizable. Drag the divider to give it more or less space.

Terminal Settings

Global terminal settings are available under Settings > Terminal.

Terminal settings page showing Performance, Font, Shell, and Startup sections

  • Performance: configure the visible emit rate (FPS for terminals you can see, default 30) and hidden emit rate (FPS for background terminals, default 5)
  • Font: choose a terminal font (defaults to JetBrains Mono) and a separate Powerline font for Powerline/Nerd Font symbols
  • Shell: set a default shell (leave blank to use system $SHELL) and default working directory (leave blank to use home directory)
  • Startup: toggle auto-respawn to automatically reopen previously active terminals when the app starts
  • Sessions: view and manage all terminal sessions across your projects

Session Persistence

Terminal sessions are persistent. When you switch to another tab and come back, the session is still running. Sessions also survive app restarts: the terminal reattaches to the same PTY process, preserving your scroll history and working directory.

The status bar at the bottom shows the current project and stage context (e.g. wp-test-site > Dev), along with server status.

SSH Connections

You can add SSH connections to access remote servers directly from RightPlace.

Adding an SSH Connection

  1. Open the Add Resource dialog in your project
  2. Choose SSH as the resource type
  3. Enter the connection details: host, port, and username
  4. Select an authentication method:
    • Password: enter the server password
    • SSH Key File: select a key file from your local machine (with optional passphrase)
    • SSH Key Paste: paste the key content directly (with optional passphrase)
  5. Click Test Connection to verify, then save

Credentials are stored in an encrypted vault. They are never logged or stored in plain text.

Using an SSH Session

Once connected, the SSH terminal works just like a local terminal session. You get the same GPU-accelerated rendering, the same Prompt and History panel, and the connection info is shown at the top of the session.

If the connection drops, the tab closes automatically. You can reconnect by opening the SSH resource again.

Widget

Appears when a Terminal tab is active. Reserved for future terminal-specific tools and information.

Next steps