Shell Prompt Integration

Sub-millisecond runtime execution surfacing your active Git identity directly inside your terminal shell.

Committing code using the wrong author context often occurs because developers lack instant visual feedback regarding which identity profile owns their current terminal workspace directory.

GitSetu includes a specialized, high-speed Prompt Engine designed specifically to expose your active workspace context natively inside your command prompt ($PS1), Oh-My-Zsh themes, and cross-shell tools like Starship.

The Performance Paradigm

Rendering logic inside terminal prompt structures executes every single time you hit Enter. If a prompt integration spawns external binary runtimes, executes multi-stage subprocesses, or queries network layers, shell interactivity grinds to a halt.

GitSetu’s prompt subcommand is engineered with absolute performance constraints:

• Pure Native Bash Parsing: Scans pre-compiled configuration routing links natively using direct memory offsets.
• Zero Subshell Spawning: Bypasses costly fork() syscalls entirely during state reads.
• Sub-2ms Execution: Total context identification completes consistently in < 2 milliseconds, keeping your command-line workflow blisteringly responsive.

Integration Setup

Standard Bash (~/.bashrc)

To prepend the active profile identifier directly to your terminal prompt line, append the following snippet to your shell configuration profile:

# GitSetu Native Shell Prompt Integration
gitsetu_ps1() {
    local profile
    # Rapidly extract current profile context silently
    profile=$(gitsetu prompt 2>/dev/null)
    if [ -n "$profile" ]; then
        echo "[$profile] "
    fi
}

# Update PS1 command rendering chain
PS1='$(gitsetu_ps1)'$PS1

Zsh / Oh-My-Zsh (~/.zshrc)

Integrate context flags gracefully inside custom Zsh layout strings:

# Enable command substitution within Zsh prompt evaluation
setopt PROMPT_SUBST

gitsetu_prompt_info() {
    local profile=$(gitsetu prompt 2>/dev/null)
    [[ -n "$profile" ]] && echo "%{$fg[cyan]%}[$profile]%{$reset_color%} "
}

# Inject cleanly ahead of standard prompt strings
PROMPT='$(gitsetu_prompt_info)'$PROMPT

Starship Cross-Shell Prompt (~/.config/starship.toml)

For developers leveraging the popular high-speed Starship engine, provision a dedicated custom module block:

[custom.gitsetu]
command = "gitsetu prompt"
when = "gitsetu prompt >/dev/null 2>&1"
format = "via [$output]($style) "
style = "bold cyan"

Output Behavior

When traversing across folders, visual updates render instantly:

# Inside unmapped general directories
~ ❯ cd ~/work/api-gateway
# Context updates instantly mid-flight
[work] ~/work/api-gateway ❯