Skip to content

Shell Enhancements

Productivity scripts loaded into your shell via shell/bashrc.d/. Installed by shell/install-shell.sh.

Scripts

Script Purpose Key Features
prompt.sh Custom PS1 prompt Git branch, status indicators, exit code colors, path shortening
aliases.sh Shell aliases Short commands for git, docker, kubectl, navigation
ai-assist.sh AI integration Shell-based AI helper commands, context builders
functions.sh Utility functions mkcd, extract, port-kill, quick-serve, json-pretty
completions.sh Tab completions Custom completions for project-specific commands

Installation

cd void-filter
./shell/install-shell.sh
# Adds: source ~/.bashrc.d/*.sh to your .bashrc

File Details

prompt.sh

Feature Description
Git branch display Shows current branch in prompt
Status indicators Dirty/clean/staged/untracked markers
Exit code coloring Red prompt on last-command failure
Directory shortening Truncates long paths

aliases.sh

Category Examples
Git gs (status), gc (commit), gp (push), gl (log)
Docker dps, dex, dlog, dprune
Navigation .., ..., projects, repos

ai-assist.sh

Feature Description
Context builder Collects repo context for AI prompts
Command suggestion Shell command suggestions from natural language

functions.sh

Function Description
mkcd mkdir + cd in one command
extract Universal archive extractor (tar, zip, gz, bz2)
port-kill Kill process on a given port
json-pretty Pretty-print JSON from stdin or file

completions.sh

Feature Description
Project commands Tab-complete project-specific scripts
Hook management Complete hook names for enable/disable