Hash

Key Dependencies

• mvdan.cc/sh — POSIX shell parser/interpreter
• charmbracelet/bubbletea — TUI framework
• charmbracelet/lipgloss — Styling
• creack/pty — PTY handling
• mattn/go-sqlite3 — History storage

Installation

Development Setup

If you're developing Hash from source, you can optionally add these helper functions to ~/.hashrc:

```bash

Quick rebuild for testing (runs from working tree)

hash-rebuild() { [[ -z "$HASH_SRC" ]] && echo "Set HASH_SRC to your hash source directory" && return 1 (cd "$HASH_SRC" && ./scripts/build.sh) "$HASH_SRC/hash" --version }

Build and install to /usr/local/bin (stable location)

hash-upgrade() { [[ -z "$HASH_SRC" ]] && echo "Set HASH_SRC to your hash source directory" && return 1 (cd "$HASH_SRC" && ./scripts/build.sh --install) /usr/local/bin/hash --version } ```

This lets you run hash-rebuild to quickly test changes, or hash-upgrade to install a new version system-wide.

~/.hash_profile - login shell setup (PATH, env vars)

export PATH="$HOME/.local/bin:$PATH" export EDITOR=hx

~/.hashrc - interactive shell setup (aliases, functions)

alias ll='ls -la' alias g='git' ```

Install VHS

brew install vhs # or: go install github.com/charmbracelet/vhs@latest

Demo Recordings

Demo GIFs are generated using VHS:

```bash

Generate all demos

for tape in demos/*.tape; do vhs "$tape"; done ```

See demos/README.md for available demos.

This project uses jj (Jujutsu) for version control.

Configurable Builtins

Disable built-in commands to use external alternatives like zoxide or eza:

[shell]
disable_builtins = ["cd"]  # Let zoxide handle cd

Configuration

Hash uses TOML configuration at ~/.config/hash/config.toml:

[shell]
editor = "hx"
keybindings = "helix"

[agent]
transport = "stdio"
command = "claude-code-acp"
timeout = "120s"

[completions]
fuzzy = true
file_icons = true

[history]
enabled = true

See docs/config-reference.md for the complete reference.

Debug Environment Variables

These environment variables are for debugging and advanced use cases:

Example: Shell tracing

```bash

Clipboard Integration

Copy commands and output without reaching for the mouse:

Shell Integration

Hash emits standard shell integration escape sequences (OSC 133) supported by modern terminals. This enables:

• Prompt navigation — Jump between commands with Cmd+Up/Down (iTerm2) or Ctrl+Shift+Z/X (Kitty/Ghostty)
• Output selection — Triple-click or Cmd+click to select entire command output
• Directory inheritance — New tabs/panes open in the current working directory
• Smart resizing — Prompts redraw cleanly when terminal is resized

Shell integration works automatically with no configuration required. Supported terminals include iTerm2, Ghostty, Kitty, WezTerm, and Windows Terminal.