Completing the Terminal Stack: Bash, Starship, and History Tools

The Portability Question

Every shell choice involves a tradeoff: features vs ubiquity.

Fish has amazing defaults—syntax highlighting, autosuggestions, sane scripting. But it’s not POSIX-compatible, so scripts break. And it’s not installed by default anywhere.

Zsh has plugins for everything. But plugin managers add complexity, and “everything” includes a lot you don’t need.

Bash is everywhere. Every server, every container, every CI runner. No installation, no compatibility issues. The skills transfer.

My choice: Stay on Bash, but layer modern tools on top. I get portability and power.

Starship: One Prompt Everywhere

The problem: Shell prompts are shell-specific. A Zsh prompt config doesn’t work in Bash. If you switch shells, you reconfigure everything.

The solution: Starship is a standalone binary. It works with Bash, Zsh, Fish, PowerShell, even Nushell. One config, every shell.

# In .bashrc, .zshrc, or config.fish
eval "$(starship init bash)"  # or zsh, fish, etc.

The mental model: The prompt is a separate concern from the shell.

What Starship Shows

Starship auto-detects context:

~/projects/myapp on  main via  v20.10.0 via 🐍 v3.11.0
❯

• Directory path
• Git branch and status (only in git repos)
• Node version (only in Node projects)
• Python version (only in Python projects)

Enter a different directory, the prompt adapts. No configuration per project.

# ~/.config/starship.toml

# Compact - no extra newline
add_newline = false

# Only show slow command duration
[cmd_duration]
min_time = 2000  # 2 seconds

# Clear success/failure indicator
[character]
success_symbol = "[➜](bold green)"
error_symbol = "[✗](bold red)"

# Only detect languages I actually use
[nodejs]
detect_files = ["package.json"]

[python]
detect_files = ["requirements.txt", "pyproject.toml"]

[rust]
detect_files = ["Cargo.toml"]

History: Three Tools, One Interface

The problem: Bash’s built-in history is primitive. Ctrl+R does substring search. No fuzzy matching, no context awareness, no sync across machines.

The insight: History search is a separate concern. Replace it without replacing the shell.

I use three tools interchangeably, all bound to Ctrl+R:

Atuin (Default)

Stores history in SQLite. Fuzzy search. Filters by directory, exit code, time. Optional cloud sync.

Key insight: Directory-aware search. In project A, Ctrl+R prioritizes commands from project A. Your global history doesn’t pollute project context.

McFly

Neural network predicts which command you want based on:

• Current directory
• Recent commands
• Exit codes (successful commands rank higher)
• Frequency

Tradeoff: Smarter but heavier. Better for long sessions where context matters.

fzf

General-purpose fuzzy finder. Less smart than the others, but starts instantly and works everywhere.

Tradeoff: No context awareness, but zero startup overhead.

Switching Between Them

# In .bashrc
case "${HISTORY_TOOL:-atuin}" in
    atuin) eval "$(atuin init bash)" ;;
    mcfly) eval "$(mcfly init bash)" ;;
    fzf)   eval "$(fzf --bash)" ;;
esac

Start a shell with a specific tool:

HISTORY_TOOL=mcfly bash

The mental model: History backend is pluggable. The interface (Ctrl+R) stays consistent.

# Atuin
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# McFly (Arch)
paru -S mcfly

# fzf (most package managers)
sudo pacman -S fzf  # Arch
brew install fzf    # macOS

Shell Integration: The Glue

For Kitty to open new tabs in your current directory, it needs to know where you are. Terminals and shells don’t share this information by default.

The mechanism: OSC 7. An escape sequence that reports the current directory.

# In .bashrc
if [[ -n "$KITTY_WINDOW_ID" ]]; then
    _kitty_report_pwd() {
        printf '\e]7;file://%s%s\e\\' "$HOSTNAME" "$PWD"
    }
    PROMPT_COMMAND="_kitty_report_pwd${PROMPT_COMMAND:+;$PROMPT_COMMAND}"
fi

This runs after every command and tells Kitty where you are. Now Ctrl+Shift+T opens a tab here, not in $HOME.

The pattern: Terminal and shell cooperate via escape sequences. Same mechanism powers Starship’s timing, Atuin’s history capture, and more.

The Complete Stack

block-beta
  columns 1
  block:layer1["Terminal Layer"]:1
    kitty["Kitty (GPU rendering)"]
  end
  block:layer2["Shell Layer"]:1
    bash["Bash (portable, everywhere)"]
  end
  block:layer3["Enhancements"]:1
    columns 2
    starship["Starship"]
    history["Atuin/McFly/fzf"]
  end

Each layer is independently replaceable:

• Don’t like Bash? Starship works with Zsh
• Don’t like Atuin? Swap in fzf
• Don’t like Kitty? Everything else still works

The mental model: Unix philosophy applied to shell setup. Small tools, clear interfaces, compose freely.

Next in this series: From Terminal to Development Environment: Putting It All Together