clipboard-stash

A tiny, dependency-free "scratch clipboard" backed by ~/.cache/clipboard-stash/stash.tsv. Each entry has a slug, timestamp, and one-line content. Multi-line text is preserved via \ escaping inside the TSV.

When to use

• The user says "stash this", "记一下这段", "先放着待会用", or asks to recall a previous snippet.
• You need a session-spanning scratch buffer that survives shell restarts but does not deserve a real note in MEMORY.md.

When NOT to use

• For long-term knowledge that belongs in MEMORY.md or memory/YYYY-MM-DD.md.
• For binary content, files, or anything > ~4 KB per entry.
• For secrets — the stash file is plaintext.

Commands

All commands are pure bash one-liners — no install needed.

Save a snippet

mkdir -p ~/.cache/clipboard-stash
slug="$1"; shift; content="$*"
printf '%s	%s	%s\
' "$slug" "$(date -Is)" "${content//$'\
'/\\
}" \
  >> ~/.cache/clipboard-stash/stash.tsv

List recent snippets

tail -n 20 ~/.cache/clipboard-stash/stash.tsv | column -t -s $'	'

Recall by slug (latest match)

slug="$1"
awk -F'	' -v s="$slug" '$1==s {last=$0} END {print last}' \
  ~/.cache/clipboard-stash/stash.tsv \
  | awk -F'	' '{gsub(/\\
/, "\
", $3); print $3}'

Clear all

: > ~/.cache/clipboard-stash/stash.tsv

Notes

• TSV columns: slug iso8601 content (newlines escaped as \ ).
• Slugs are not unique — recall returns the latest matching entry.
• Safe to cat the file directly to inspect history.