Terminal

Shell Integration & Profiles

Gunamaya's terminal understands your shell well enough to add command decorations, detect your working directory, and jump between past commands — on top of being a fully standard terminal.

Shell integration

When shell integration is active (automatic for the common shells: PowerShell, bash, zsh, and fish), the terminal gains a few extras a plain terminal emulator doesn't have:

Command decorations

A colored marker appears in the gutter next to each command's output, showing at a glance whether it succeeded or failed.

Command navigation

Jump to the start of the previous or next command's output with Ctrl+Up/Down, instead of scrolling manually through a long build log.

Working directory detection

Gunamaya always knows your terminal's current directory, which is what lets a new split or terminal open in the same place you already are.

Sticky scroll

The currently-running command's line stays pinned at the top of the terminal while its output scrolls beneath it, in long-running commands.

If decorations don't appear

Shell integration installs a small script into your shell's startup automatically. If you use an unusual shell configuration that skips standard startup files, run Terminal: Show Shell Integration Status for a diagnostic, or disable it entirely with terminal.integrated.shellIntegration.enabled.

Shell profiles

A profile is a named terminal configuration — which shell binary to run, with what arguments, in what starting directory. Gunamaya detects the shells already installed on your system and offers them as profiles automatically; define your own for anything more specific (a particular WSL distribution, a Python virtual environment activation, a remote SSH session).

1

Open profile settings

Run Terminal: Select Default Profile from the Command Palette to see everything detected, or Terminal: Configure Terminal Settings to define a custom one.

2

Set per-platform defaults

Profiles are keyed by platform (terminal.integrated.defaultProfile.windows, .osx, .linux), so a settings file synced across your machines can specify a different default shell for each without conflicting.

3

Pick a profile per terminal

The + dropdown in the terminal tab bar lets you open a specific profile for just that one terminal, without changing your overall default.

Terminal appearance

Font, cursor style, and color are independently configurable from the editor's — search terminal.integrated.fontFamily and terminal.integrated.fontSize in Settings, or let the terminal inherit the editor's font by leaving them unset.