Quick Start

Welcome to hash shell! This guide will help you get started with the basics.

First Steps

After installing hash, start it by running:

hash-shell

You’ll see:

hash v34
Type 'exit' to quit

#>

Basic Commands

Hash works like any POSIX shell:

#> echo "Hello, World!"
Hello, World!

#> ls -la
# Lists files

#> cd ~/projects
# Changes directory

#> pwd
/home/user/projects

Command Line Options

Examples

# Execute a command
hash-shell -c 'echo "Hello!"'

# Run a script
hash-shell script.sh

# Run as login shell
hash-shell --login

Configuration

Hash loads configuration from ~/.hashrc on startup. Create your configuration file:

cp /path/to/hash/examples/.hashrc ~/.hashrc

Or create a minimal one:

# ~/.hashrc
alias ll='ls -lah'
alias gs='git status'
set PS1='\W\g \e#>\e '

See Configuration (.hashrc) for complete details.

Key Features

• Line Editing: Arrow keys, Ctrl+A/E, history navigation
• Tab Completion: Complete commands, files, and directories
• Git Integration: Branch and status in prompt
• Aliases: Create command shortcuts
• Scripting: POSIX-compatible shell scripts

Next Steps

• Configure your .hashrc - Customize your shell
• Set up as login shell - Make hash your default
• Learn line editing - Master keyboard shortcuts
• Write scripts - Automate tasks