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.

The profile selector lives in the toolbar's new-tab button. Left-click to open a tab with the default profile; right-click to choose from the full list.

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
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.

Left-click the +› button to open a new tab with the default profile.

Right-click the +› button to open the profile dropdown. Only profiles whose shell path exists on disk appear in the list.

🗂 SCREENSHOT — profile dropdown

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.