hoard-rs

command organizer tool to hoard all your precious commands 💎🐉

What is a command organizer?

A command organizer lets you save commands that you often use, but are too complicated or long to remember. For every hoarded command, hoard saves

• the command ( parameterized with a customizable token, default # )
• name
• description
• namespace where it lives in
• tags ( Optional )

If you get lost in your massive command history, and can't find for example a specific docker command out of thousand docker commands you've already ran, just hoard it. With a name and description it will be much easier to find again. When you look for that command again a month later, take a look at your hoarded commands.

hoard is not supposed to replace shell history finder like fzf atuin or similar utilities. It rather should be used in conjunction with them.

Now with chatGPT integration 💎

:love_letter: Table of contents

• 📦 Install
• 🤸 Usage
• :zap: Shortcuts

It's best to use rustup to get setup with a Rust toolchain, then you can run:

cargo install hoard-rs

Or build it yourself:

cargo build --release

Find the binaries in ./target/release/hoard Move it to wherever you need it ( Like /usr/local/bin/hoard ) Or run

cargo install --path .

Linux

Tested on:

• Ubuntu
• Arch
• EndeavourOS

Install hoard by running

./install.sh

If you are running fish shell

LATEST_RELEASE=1.4.2 ./install.fish

AUR (Arch Linux)

paru -S hoard

Homebrew (macOS)

brew tap Hyde46/hoard
brew install hoard

MacPorts (macOS)

sudo port install hoard-cli

More info here

Windows

Best to install from source, good luck

Autocomplete with Shell plugin

Install hoard as a plugin to enable autocomplete. Depending on your shell, run one of the following commands. To keep it installed for your next shell session, add the source command with an absolute path to your .bashrc or copy-paste the plugins content to your .bashrc.

bash

source src/shell/hoard.bash

zsh

source src/shell/hoard.zsh

fish

source src/shell/hoard.fish

Nix

The hoard package is in the nixpkgs package repository.

Either install it with nix-env -iA hoard, get it temporarily with nix-shell -p hoard or add it to your configuration.

hoard new

echo "My name is #first and I live at #city. Did I tell you my name, #first?" 

echo "My name is #first named parameter! and I live at #city. Did I tell you my name, #first?" 

<Ctrl-h>

hoard list

If you dont already have an OpenAI account to generate an API key, head to this page. ( Given the low amount of tokens consumed, this is extremly cheap. ~ 0.01$ for 30 generated commands )

You either need to set the env variable

export OPENAI_API_KEY=abcabcabc

Or for a permanent solution set gpt_api_key in your ~/.config/hoard/config.yml

chatGPT does not always reply in the same format. Sometimes the resulting command will be added to the description. Use the edit mode <TAB>/<Ctrl-E> to edit the hoarded command to its correct form.

Synchronize commands with another terminal

You can keep your commands in sync in multiple terminals by using hoard sync

First register a new account

hoard sync register

Then login with your new account

hoard sync login

Save your local commands online

hoard sync save

Login with the same account on a different computer/terminal and then run

hoard sync get

This will merge your local trove file with the cloud-based one. You will get prompted how to handle collisions if there are any. However, if you are unhappy with how the merge happened, you've got the option to revert the latest hoard sync get command

hoard sync revert

If you want to host your own sync server, checkout it's repository. Then, update your config file to point to the new server location ~/.config/hoard/config.yml

Delete a command

hoard remove <name>

Delete all commands in a namespace

hoard remove_namespace <namespace_name>

Edit a command

hoard edit <name>

Info

Shows location of config file and trove file

hoard info

Set parameter token

Change parameter token of config file

hoard set_parameter_token <parameter_token>

Import other trove files from trove.yml or urls pointing to a trove.yml file

hoard import /path/to/trove.yml

or

hoard import https://troves.com/new_trove.yml

Export trove file

hoard export /path/to/exported/trove.yml

<F1>

<Ctrl-N> / <Down-Arrow>

<Ctrl-P> / <Ctrl-Y> / <Up-Arrow>

<Ctrl-L> / <Right-Arrow>

<Ctrl-H> / <Left-Arrow>

<Enter>

<Esc> / <Ctrl-D> / <Ctrl-C> / <Ctrl-G>