recall

README

recall

A CLI tool to find commands by describing what you want to do when you forget them

Motivation

Even after years of working as a software engineer, I still find myself forgetting commands and searching for them again and again.

You could search your shell history, keep notes, or ask ChatGPT, but sometimes that might feel like overkill.

I thought it might be helpful to have something that provides a similar UX to asking ChatGPT, but directly in the terminal.

Installation

Github Release

Download the latest binary from releases.

Homebrew

brew tap spider-hand/tap
brew install recall

Go

go install github.com/spider-hand/recall@latest

Usage

Basic Usage

Search

Search commands by describing what you want to do:

recall <query>

Example:

recall delete branch

Output example:

delete local branch
$ git branch -d <branch>

If multiple results are found, they are listed:

1) delete local branch
   $ git branch -d <branch>

2) delete remote branch
   git push origin --delete <branch>
   $ git fetch -p

Add

recall --add

Example:

description: delete local branch

> git branch -d <branch>

You can enter multiple commands. Press Enter on an empty line to finish.

Example:

description: undo last commit

> git reset --soft HEAD~1
> git reset

Other Actions

-a, --add               Add a new entry
-e, --edit <query>      Edit an entry
-d, --delete <query>    Delete an entry
-l, --list              List all entries
-v, --version           Show version
-h, --help              Show help message

License

MIT