Skip to content

Commit 40b9f09

Browse files
committed
docs: README
1 parent 6365fdd commit 40b9f09

File tree

1 file changed

+39
-6
lines changed

1 file changed

+39
-6
lines changed

README.md

Lines changed: 39 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,51 @@
11
# Stacks [![CI](https://github.com/cablehead/stacks/actions/workflows/rust.yml/badge.svg)](https://github.com/cablehead/stacks/actions/workflows/rust.yml) [![Discord](https://img.shields.io/discord/1182364431435436042?logo=discord)](https://discord.com/invite/YNbScHBHrh)
22

3-
Stacks is a tool to track and manipulate your current context, with pipes and
4-
filters. To be honest, I'm not quite sure what it is, or where it's going, but
5-
let's keep things simple and say it's a clipboard manager.
3+
Stacks is a clipboard manager.
4+
5+
![screenshot](./docs/screenshots/screenshot.png)
6+
7+
## About
8+
9+
With so many great clipboard managers already available, why create another one?
10+
11+
I think of my clipboard as "picking things up" to move them around or redirect
12+
them. In this sense, your system's clipboard acts as a strong proxy for your
13+
["locus of attention"](https://www.oreilly.com/library/view/humane-interface-the/0201379376/0201379376_ch02lev1sec3.html)
14+
when you're using a computer.
15+
16+
A clipboard manager, then, is a tool to capture and work with your "locus of
17+
attention." It ambiently captures your current tasks and work _context_.
18+
19+
Stacks is an experimental tool for tracking and manipulating your current
20+
context using pipes and filters. But that’s a lot to explain, so I usually just
21+
describe it as a clipboard manager.
622

723
A humble clipboard manager aspiring to elevate the depth of our conversations—
824
no less.
925

10-
![screenshot](./docs/screenshots/screenshot.png)
11-
1226
It's free, as in beer, but mostly as in 'freedom', and it's also open source. If
1327
you're into that sort of thing, give it a spin!
1428

15-
## Download
29+
## UX disclaimer
30+
31+
A quick note on the user experience (UX): it’s fair to say it’s still a bit
32+
rough around the edges. If Stacks reaches a UX level similar to (neo)vim, I'd
33+
consider that a success. It’s pretty spartan and utilitarian, so being
34+
comfortable with the command line, or feeling adventurous, definitely helps.
35+
36+
Stacks is my personal
37+
["tool for thought"](https://maggieappleton.com/tools-for-thought) that I use as
38+
my daily driver. Eventually, I’d like Stacks to reach the polish of tools like
39+
[Obsidian](https://obsidian.md), but for now, the focus is on its experimental
40+
nature and the underlying
41+
[event-sourcing store](https://github.com/cablehead/xs).
42+
43+
## Give it a try!
44+
45+
If you're into experimental tools and are okay with a minimalist,
46+
utilitarian design, give Stacks a try-- I'd love to hear your thoughts!
47+
48+
### Download
1649

1750
`.DMG` installers that have been notarized by Apple.
1851

0 commit comments

Comments
 (0)