GitHunt
AL

alexalemi/stash

A simple append-only note taker.

Stash

A simple append-and-review note system inspired by Andrej Karpathy's tweet about keeping a running stack of notes—push things to the top, review when you get around to it.

Notes are stored in ~/stash.txt.

Usage

stash                  # Open editor with timestamp prepended—write your note, save, done
stash "quick note"     # Push a timestamped note without opening editor
stash push "note"      # Same as above (explicit)
stash peek             # Show the top note
stash pop              # Remove and show the top note
stash edit             # Open the entire file in your editor

Install

# Copy or symlink to somewhere in your PATH
mkdir -p ~/bin
ln -sf /path/to/stash ~/bin/stash

# Ensure ~/bin is in PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$HOME/bin:$PATH"

Configuration

  • $EDITOR - Your preferred editor (defaults to vim)
  • Notes are stored in ~/stash.txt

Languages

Shell100.0%

Contributors

MIT License
Created December 11, 2025
Updated December 11, 2025
alexalemi/stash | GitHunt