1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
[](https://github.com/orkohunter/keep/releases) 
# A Meta CLI toolkit
> Your personal shell command keeper
## Why?
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?
## Features
- 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.**
## Installation
$ pip3 install keep
Use Python 3.6 or later.
You can install pip3 using apt-get as `sudo apt install python3-pip`.
## Usage
Usage: keep [OPTIONS] COMMAND [ARGS]...
Keep and view shell commands in terminal only.
Read more at https://github.com/orkohunter/keep
Options:
-v, --verbose Enables verbose mode.
--help Show this message and exit.
Commands:
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.](https://github.com/OrkoHunter/keep/blob/master/tutorial.md)
### Command-line Completion
To enable command-line completion (TAB completion) follow these steps for the shell of your choice
#### bash
1. Create a directory in your home directory called `.bash`
mkdir -p $HOME/.bash
2. Copy [completion/keep.bash](https://github.com/OrkoHunter/keep/blob/master/completions/keep.bash) to `$HOME/.bash/keep`
curl -SLo "$HOME/.bash/keep" "https://raw.githubusercontent.com/OrkoHunter/keep/master/completions/keep.bash"
3. Add the following lines to `$HOME/.bashrc` file
[ -f "$HOME/.bash/keep" ] && . "$HOME/.bash/keep"
#### zsh
1. Create a directory in your home called `.zsh`
mkdir -p $HOME/.zsh
2. Copy [completion/keep.zsh](https://github.com/OrkoHunter/keep/blob/master/completions/keep.zsh) to `$HOME/.zsh/_keep`
curl -SLo "$HOME/.zsh/_keep" "https://raw.githubusercontent.com/OrkoHunter/keep/master/completions/keep.zsh"
3. Add the following lines inside `$HOME/.zshrc` file
fpath=($HOME/.zsh $fpath)
autoload -Uz compinit && compinit
### Contribute
This is a very young project. If you have got any suggestions for new
features or improvements, please comment over
[here](https://github.com/OrkoHunter/keep/issues/11). Pull Requests are
most welcome !
❤
---
Not a command line fanatic? Here are some resources for you :
- <https://github.com/jlevy/the-art-of-command-line>
- <https://github.com/herrbischoff/awesome-osx-command-line>
- <https://github.com/alebcay/awesome-shell>
- <https://github.com/aharris88/awesome-cli-apps>
|
