{"id":13557393,"url":"https://github.com/OrkoHunter/keep","last_synced_at":"2025-04-03T11:32:00.393Z","repository":{"id":39656669,"uuid":"46737100","full_name":"OrkoHunter/keep","owner":"OrkoHunter","description":"A Meta CLI toolkit : Personal shell command keeper and snippets manager","archived":false,"fork":false,"pushed_at":"2024-07-31T20:03:24.000Z","size":496,"stargazers_count":608,"open_issues_count":15,"forks_count":54,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-28T05:06:07.217Z","etag":null,"topics":["command-line","linux","python","shell","terminal"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OrkoHunter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-11-23T17:36:10.000Z","updated_at":"2025-03-17T14:48:27.000Z","dependencies_parsed_at":"2024-11-28T08:04:03.732Z","dependency_job_id":null,"html_url":"https://github.com/OrkoHunter/keep","commit_stats":{"total_commits":129,"total_committers":23,"mean_commits":5.608695652173913,"dds":0.5503875968992248,"last_synced_commit":"f70521b4e5f268b238f71740378c011c5738a9d9"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OrkoHunter%2Fkeep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OrkoHunter%2Fkeep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OrkoHunter%2Fkeep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OrkoHunter%2Fkeep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OrkoHunter","download_url":"https://codeload.github.com/OrkoHunter/keep/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246993124,"owners_count":20865941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-line","linux","python","shell","terminal"],"created_at":"2024-08-01T12:04:19.449Z","updated_at":"2025-04-03T11:31:55.383Z","avatar_url":"https://github.com/OrkoHunter.png","language":"Python","readme":"![logo](https://raw.githubusercontent.com/OrkoHunter/keep/master/data/logo.png#gh-light-mode-only)\n\n![logo](./data/logo-white.png#gh-dark-mode-only)\n\n[![PyPI](https://img.shields.io/pypi/v/keep)](https://github.com/orkohunter/keep/releases) ![PyPI - Downloads](https://img.shields.io/pypi/dm/keep)\n\n# A Meta CLI toolkit\n\n\u003e Your personal shell command keeper\n\n## Why?\n\nWritwick Wraj loves using the command line.\n\nWritwick googles \\\"How to do X in terminal?\\\" and multiple forums and\nblog posts finally provide him the magical _command_ for the rescue.\nProblem Solved !\n\nFast forward couple weeks, Writwick has to do X in terminal, again. Wraj\nremembers solving this few weeks ago. Let him do a reverse-i-search with\n_Ctrl+R_. Nope, can\\'t remember sh\\*t. Browser search history? 25 web\npages found matching _X_. Argh!\n\nWritwik finally finds the solution. From this time Writwik starts\nwriting the commands somewhere online for the future.\n\nWait, why shouldn\\'t he keep the command in his terminal itself if this\nis only place where he\\'ll ever have use it?\n\n## Features\n\n- Save a new command with a brief description\n- Search the saved commands using powerful patterns\n- Save the commands as a secret GitHub gist\n- Use `keep push` and `keep pull` to sync the commands between GitHub\n  gist and other computers.\n\n**ProTip : Save the commands you usually forget in ssh sessions and sync\nit with your local machine.**\n\n## Installation\n\n    $ pip3 install keep\n\nUse Python 3.6 or later.\n\nYou can install pip3 using apt-get as `sudo apt install python3-pip`.\n\n## Usage\n\n    Usage: keep [OPTIONS] COMMAND [ARGS]...\n\n      Keep and view shell commands in terminal only.\n\n      Read more at https://github.com/orkohunter/keep\n\n    Options:\n      -v, --verbose  Enables verbose mode.\n      --help         Show this message and exit.\n\n    Commands:\n      edit          Edit a saved command.\n      github_token  Register a GitHub Token to use GitHub Gists as a backup.\n      grep          Searches for a saved command.\n      init          Initializes the CLI.\n      list          Shows the saved commands.\n      new           Saves a new command.\n      pull          Pull commands from saved GitHub gist.\n      push          Push commands to a secret GitHub gist.\n      rm            Deletes a saved command.\n      run           Executes a saved command.\n      update        Check for an update of Keep.\n\n[See the detailed usage and\ntutorial.](https://github.com/OrkoHunter/keep/blob/master/tutorial.md)\n\n### Command-line Completion\n\nTo enable command-line completion (TAB completion) follow these steps for the shell of your choice\n\n#### bash\n\n1. Create a directory in your home directory called `.bash`\n\n        mkdir -p $HOME/.bash\n\n2. Copy [completion/keep.bash](https://github.com/OrkoHunter/keep/blob/master/completions/keep.bash) to `$HOME/.bash/keep`\n\n        curl -SLo \"$HOME/.bash/keep\" \"https://raw.githubusercontent.com/OrkoHunter/keep/master/completions/keep.bash\"\n\n3. Add the following lines to `$HOME/.bashrc` file\n\n        [ -f \"$HOME/.bash/keep\" ] \u0026\u0026 . \"$HOME/.bash/keep\"\n\n#### zsh\n\n1. Create a directory in your home called `.zsh`\n\n        mkdir -p $HOME/.zsh\n\n2. Copy [completion/keep.zsh](https://github.com/OrkoHunter/keep/blob/master/completions/keep.zsh) to `$HOME/.zsh/_keep`\n\n        curl -SLo \"$HOME/.zsh/_keep\" \"https://raw.githubusercontent.com/OrkoHunter/keep/master/completions/keep.zsh\"\n\n3. Add the following lines inside `$HOME/.zshrc` file\n\n        fpath=($HOME/.zsh $fpath)\n        autoload -Uz compinit \u0026\u0026 compinit\n\n### Contribute\n\nThis is a very young project. If you have got any suggestions for new\nfeatures or improvements, please comment over\n[here](https://github.com/OrkoHunter/keep/issues/11). Pull Requests are\nmost welcome !\n\n❤\n\n---\n\nNot a command line fanatic? Here are some resources for you :\n\n- \u003chttps://github.com/jlevy/the-art-of-command-line\u003e\n- \u003chttps://github.com/herrbischoff/awesome-osx-command-line\u003e\n- \u003chttps://github.com/alebcay/awesome-shell\u003e\n- \u003chttps://github.com/aharris88/awesome-cli-apps\u003e\n","funding_links":[],"categories":["Python","linux","terminal"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOrkoHunter%2Fkeep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOrkoHunter%2Fkeep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOrkoHunter%2Fkeep/lists"}