DeepBlue Dynamics / Docs / Hyperia / Shell Profiles

Shell Profiles

Launch different shells and tools as named profiles.

Overview

A shell profile is a named launch configuration — a shell binary, optional arguments, environment variables, and working directory. Profiles let you switch between bash, zsh, PowerShell, or any interactive tool (like Nemesis8) without touching the config file every time.

Every profile is picked from the Chooser — the picker that opens whenever you add a tab or split a pane. Hyperia auto-detects a starter set of profiles at startup and adds them to the Chooser without you touching config:

Windows — PowerShell, CMD, Git Bash, and every installed WSL distro
macOS / Linux — zsh, bash, fish (whichever are on PATH)
Both — Claude Code and Nemesis8 (as kind: "agent" profiles) if either is on PATH

Add your own profiles for anything else. Custom profiles appear in the Chooser alongside the auto-detected set.

Default profile

If no profiles are defined, Hyperia detects and uses your system's default shell — $SHELL on macOS/Linux, PowerShell on Windows. This shell is used for every new tab and split pane unless you specify otherwise.

To override the default, set defaultProfile in your config:

{
  "config": {
    "defaultProfile": "zsh",
    "profiles": [...]
  }
}

Defining profiles

Profiles live in the config.profiles array. Each profile needs a name and a config block with at least a shell path.

{
  "config": {
    "defaultProfile": "zsh",
    "profiles": [
      {
        "name": "zsh",
        "config": {
          "shell": "/bin/zsh"
        }
      },
      {
        "name": "bash",
        "config": {
          "shell": "/bin/bash"
        }
      },
      {
        "name": "PowerShell",
        "config": {
          "shell": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"
        }
      }
    ]
  }
}

Profile options

Key	Type	Description
kind	string	`"shell"` (default) or `"agent"`. Agent-kind profiles appear in the Agent column of the Chooser.
shell	string	Absolute path to the shell or binary to launch. Must exist on disk.
shellArgs	string[]	Arguments passed to the shell on launch. E.g. `["-c", "nemesis8 interactive"]`.
env	object	Additional environment variables merged into the shell's environment.
cwd	string	Starting directory for new tabs using this profile. Defaults to `$HOME`.

The toolbar sits centered at the top of the window and fades to near-invisible when not hovered. Hover to reveal it.

Click the new-tab button, or split the current pane — the Chooser opens with two columns: a Shell column (auto-detected and custom shell profiles) and an Agent column (agent-kind profiles for Claude Code, Nemesis8, and any other kind: "agent" entries). Only profiles whose binary exists on disk appear.

🗂 SCREENSHOT — Chooser: Shell + Agent columns

Nemesis8 profile

Nemesis8 is an AI orchestrator that runs in a sealed container. Once installed, Hyperia can launch it as a shell profile — the terminal session becomes a persistent Nemesis8 interactive session.

The easiest way to set this up is through Settings → Install Nemesis8. It runs the official installer and automatically adds the profile to your config:

{
  "name": "Nemesis8",
  "config": {
    "shell": "/bin/bash",
    "shellArgs": ["-c", "/home/user/.local/bin/nemesis8 interactive"]
  }
}

On Windows the profile uses cmd.exe /c nemesis8 interactive. After install, a Nemesis8 entry appears in the profile dropdown.

Renaming tabs

Double-click any tab to rename it inline. The name persists for the life of the session and shows in the tab bar. Agents can also rename tabs programmatically via the terminal_rename MCP tool.

Right-clicking a tab shows additional options: Rename, Copy ID, and Close.