stash-cli 0.8.0

A local store for pipeline output and ad hoc file snapshots
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

# ~{@ 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/](docs)
- Scrips, and cli integrations (bash/zsh/fish, ripgrep, starship, ssh, fzf, etc.): [scripts/](scripts/)


## Installation

### From Source

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

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

### With Cargo

```bash
cargo install stash-cli
```

### Pre-built binaries

Available under [releases](https://github.com/vrypan/stash/releases).

### Homebrew

```bash
brew install vrypan/tap/stash
```

### Shell support

For auto-completion and other shell-specific features, check:
- [docs/bash.md](docs/bash.md)
- [docs/fish.md](docs/fish.md)
- [docs/zsh.md](docs/zsh.md)

## ~{@

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