Skip to content

A simple and persistent stack for use as a basic CLI clipboard between TMUX panes.

License

Notifications You must be signed in to change notification settings

jceaser/stacker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stacker

A tool for saving things to a stack to share between tmux sessions

What is this and why

I have a need to "copy and paste" things between tmux panes all the time. A standard clipboard could be used, but I don't always have a clipboard (old twm machine for instance) and some times I want the value to persist, or even stranger, I want one copy and multiple pastes. I tried fifo files, but the copy app is held till the paste app runs and it is not one to many but one to one. Also, fifo will not persist through a reboot.

This solution is to create a simple clipboard cache in a file.

Usage

Create something:

>echo thing | stacker

Peek at something:

>stacker -peek
thing

Read something, consuming it:

>stacker
thing

Show everything in a tab delimitated list:

>stacker -ls
0 thing 1
1 thing 2

Update something, replacing:

>echo wrong-thing | stacker ; echo Thing | stacker -update

Delete something

>stacker -delete

Web Usage

Use the -http flag to start the server. This mode will use -host and -port and defaults to localhost on port 54321.

Method Path Description
GET /list List stack items
GET /peek Return top item on stack
POST /rotate Rotate Stack
PUT /push Push value onto stack
DELETE /pop Pop the stack
HEAD /* Info on holdings

gRPC Usage

To communicate using gRPC over the internet, use the following flags:

Flag Option Notes
-host name URL name of the server
-port number Port number
-rpcd Start the server
-rpc list List stack items
push Push standard in onto the stack
pop Pop from the stack
peek Return top item on stack, leave it there
rotate Rotate the stack

Development

To test the application, use:

>go test ./tests/...

To build this application, take care to name the output because "stacker" is a directory:

>go build -o bin/stacker

Copyright 2024 by [email protected], all rights reserved.

About

A simple and persistent stack for use as a basic CLI clipboard between TMUX panes.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published