Skip to main content

Personal shell command keeper

Project description


A Meta CLI toolkit

Your personal shell command keeper


Writwick Wraj loves using the command line.

Writwick googles “How to do X in terminal?” and multiple forums and blog posts finally provide him the magical command for the rescue. Problem Solved !

Fast forward couple weeks, Writwick has to do X in terminal, again. Wraj remembers solving this few weeks ago. Let him do a reverse-i-search with Ctrl+R. Nope, can’t remember sh*t. Browser search history? 25 web pages found matching X. Argh!

Writwik finally finds the solution. From this time Writwik starts writing the commands somewhere online for the future.

Wait, why shouldn’t he keep the command in his terminal itself if this is only place where he’ll ever have use it?


  • Save a new command with a brief description
  • Search the saved commands using powerful patterns
  • Save the commands as a secret GitHub gist
  • Use keep push and keep pull to sync the commands between GitHub gist and other computers.

ProTip : Save the commands you usually forget in ssh sessions and sync it with your local machine.


$ pip3 install keep

Use Python 3.6 or later.

You can install pip3 using apt-get as sudo apt install python3-pip.


Usage: keep [OPTIONS] COMMAND [ARGS]...

  Keep and view shell commands in terminal only.


  -v, --verbose  Enables verbose mode.
  --help         Show this message and exit.

  edit          Edit a saved command.
  github_token  Register a GitHub Token to use GitHub Gists as a backup.
  grep          Searches for a saved command.
  init          Initializes the CLI.
  list          Shows the saved commands.
  new           Saves a new command.
  pull          Pull commands from saved GitHub gist.
  push          Push commands to a secret GitHub gist.
  rm            Deletes a saved command.
  run           Executes a saved command.
  update        Check for an update of Keep.

See the detailed usage and tutorial.


This is a very young project. If you have got any suggestions for new features or improvements, please comment over here. Pull Requests are most welcome !

Not a command line fanatic? Here are some resources for you :

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for keep, version 2.8
Filename, size File type Python version Upload date Hashes
Filename, size keep-2.8-py3-none-any.whl (14.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size keep-2.8.tar.gz (10.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page