~{@ stash

sstash is a small, efficient command line tool that saves data for future reference and integrates nicely with command line workflows.

Stash piped output or files

$ echo "hello world" | stash
$ stash Cargo.toml
$ stash demos/words.gif

Inspect your stash

$ stash ls -l

jhec0b9h  292.1K  Apr 11 05:15  *  GIF89a......1......... .. !..$..... ..&..#..(..%..+.....(..R...
z70pc1xm    777B  Apr 11 05:11  *  [package] name = "stash-cli" version = "0.6.0" edition = "20...
wve1pgsd     12B  Apr 11 05:08     hello world

Read stash entries

$ stash cat wve1pgsd
hello world

$stash cat @2 | wc -l
  35

Stash in the middle of a pipe

$ find src -type f | stash tee | wc -l
      15

$ stash cat @1 | head

src/cmd/rm.rs
src/cmd/ls.rs
src/cmd/attr.rs
src/cmd/path.rs
src/cmd/mod.rs
src/cmd/push.rs
src/display.rs
src/lib.rs
src/preview.rs

Set arbitrary attributes to each entry, either at creation time or later.

$ stash attr wve1pgsd note=test
$ stash attr jhec0b9h note=test type=gif

$ stash ls -l -a note -a type
ghvg4s0b    231B  Apr 11 05:48                src/cmd/rm.rs src/cmd/ls.rs src/cmd/log.rs src/cmd/attr.rs s...
jhec0b9h  292.1K  Apr 11 05:15  *  test  gif  GIF89a......1......... .. !..$..... ..&..#..(..%..+.....(..R...
z70pc1xm    777B  Apr 11 05:11  *             [package] name = "stash-cli" version = "0.6.0" edition = "20...
wve1pgsd     12B  Apr 11 05:08  *  test       hello world

Everything is stored as plain files under ~/.shtash (or $STASH_DIR if you set it). No fancy databases or complex data formats.

$ stash ls --date --id=full --preview --reverse

01knxf1n5ffvk9jsm8wve1pgsd  Apr 11 05:08  hello world
01knxf6yj2tdgj4k8kz70pc1xm  Apr 11 05:11  [package] name = "stash-cli" version = "0.6.0" edition = "20...
01knxfeb2hgmybg39ajhec0b9h  Apr 11 05:15  GIF89a......1......... .. !..$..... ..&..#..(..%..+.....(..R...
01knxhb7pa2wnsm0djghvg4s0b  Apr 11 05:48  src/cmd/rm.rs src/cmd/ls.rs src/cmd/log.rs src/cmd/attr.rs s...

$ file .stash/data/*

.stash/data/01knxf1n5ffvk9jsm8wve1pgsd: ASCII text
.stash/data/01knxf6yj2tdgj4k8kz70pc1xm: ASCII text
.stash/data/01knxfeb2hgmybg39ajhec0b9h: GIF image data, version 89a, 1200 x 900
.stash/data/01knxhb7pa2wnsm0djghvg4s0b: ASCII text

Documentation

Usage guide, and examples: docs/
Scrips, and cli integrations (bash/zsh/fish, ripgrep, starship, ssh, fzf, etc.): scripts/

Installation

From Source

Build the Rust binary and copy it to a location in your PATH:

cargo build --release
cp target/release/stash /usr/local/bin/stash

With Cargo

cargo install stash-cli

Pre-built binaries

Available under releases.

Homebrew

brew install vrypan/tap/stash

Shell support

For auto-completion and other shell-specific features, check:

~{@

In case you wonder, ~{@ is an ASCII-art acorn

stash-cli 0.7.1