{"id":45269683,"url":"https://github.com/dtrugman/shplug","last_synced_at":"2026-02-21T01:01:15.040Z","repository":{"id":41078551,"uuid":"420369895","full_name":"dtrugman/shplug","owner":"dtrugman","description":"Your new shell plugin manager","archived":false,"fork":false,"pushed_at":"2022-11-08T00:45:31.000Z","size":136,"stargazers_count":21,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-15T13:55:10.578Z","etag":null,"topics":["bash","plugin-manager","plugins","productivity-tools","shell","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dtrugman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-23T09:34:03.000Z","updated_at":"2024-10-03T05:15:52.000Z","dependencies_parsed_at":"2023-01-21T06:01:49.588Z","dependency_job_id":null,"html_url":"https://github.com/dtrugman/shplug","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/dtrugman/shplug","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtrugman%2Fshplug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtrugman%2Fshplug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtrugman%2Fshplug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtrugman%2Fshplug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dtrugman","download_url":"https://codeload.github.com/dtrugman/shplug/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtrugman%2Fshplug/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29669842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T00:11:43.526Z","status":"ssl_error","status_checked_at":"2026-02-20T23:52:33.807Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bash","plugin-manager","plugins","productivity-tools","shell","zsh"],"created_at":"2026-02-21T01:00:28.675Z","updated_at":"2026-02-21T01:01:15.024Z","avatar_url":"https://github.com/dtrugman.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![shplug](./img/shplug-dark.png#gh-dark-mode-only)\n![shplug](./img/shplug-light.png#gh-light-mode-only)\n**Your new shell plugin manager** - An easy solution for managing your shell environments.\n\nThere are two main use patterns:\n\n## Synced environments\n\nSync your files across multiple environments (aka machines) using a simple git repository.\n\n### Example\n\nLet's say you have 2 different machines you use for development/administration/etc.\nYou wanna sync your dotfiles: `.gitconfig`, `.vimrc`, `.bashrc`, `.tmux.conf`\nand possibly some scripts you always find useful to have on your machine.\n\nCreate a git repository, call it however you like and use the following structure:\n- [git-repo-root]\n    - install\n    - home\n        - .gitconfig\n        - .vimrc\n        - .bashrc\n        - .tmux.conf\n        - scripts\n            - my_greatest_script.sh\n            - my_awesome_script.rb\n            - my_amazing_tool.py\n\nOnce you have `shplug` installed on your machine, you can get all those goodies using a single command:\n```\nshplug env add \u003cenv-name\u003e \u003cgit-repo-url\u003e\n```\n\nFor example, I clone my [dotfiles](https://github.com/dtrugman/dotfiles) using:\n```\nshplug env add dotfiles https://github.com/dtrugman/dotfiles\n```\n\nWhen you run the command, the following will happen:\n\n1. The repository will be cloned locally into some hidden directory under your user's home (The user that executes the `shplug env add` command)\n1. All the files are going to be linked under your actual `$HOME` directory. Existing files are going to be backed-up and only then overriden. **Don't worry, you will be notified of the changes and prompted for approval.**\n1. The `install` script is going to be executed, just in case you want to automatically add the new `scripts` directory into your `$PATH` without any additional manual steps, install `plug.vim` and run `:PlugInstall` or do anything else automatically every time you sync the environment.\n\nNotes:\n1. The `install` file is optional\n1. `home` is a hard-coded keyword for the `$HOME` of the user that will be using the environment. `scripts` is just an arbitrary name you can use. Any other name will work as well\n1. You can use other root-level directories in your repository, as in, have an `app` directory next to `home`. When calling `shplug env add`, it will try to create and link those files under `/app` on your machine. Make sure that this directory exists and owned by your user, otherwise `shplug add env` will fail due to lack of permissions to create a directory under `/`.\n    - Another option is to run the command as a superuser while retaining your user's `$HOME` configuration. This might work but will definitely require further `chown`-s to fix the permissions on all the cloned files, hence ill-advised.\n\n### Plan on changing your scripts? Great!\n\nYou can edit any of your scripts and push them to your global git repository easily. After doing any changes, just enter the hidden git repo using: `shplug env cd \u003cenv-name\u003e`, and interact directly with your git repository.\n\n## Easy plugins\n\nQuickly and easily manage aliases, functions, gists and more. The plugin manager allows you to download files locally and automatically source them into your active shell.\n\nLet's say a colleague wrote a small script to handle that annoying task that broke the integration tests at work. Just get him to upload it anywhere and run: `shplug plugin add \u003cplugin-name\u003e \u003cplugin-url\u003e`.\n\nThe name can be whatever you want. Here's an example: `shplug plugin add git-describe https://gist.github.com/dtrugman/ec4d40e7b05f01251e4c688ae62219fd`\n\nYou could argue you can just add this script to your dotfiles repo, but life's dynamic and unexpected. There are different reasons to keep those separated:\n\n- You might decide to keep your dotfiles private while share some scripts with colleagues or fellow redditors\n- You wanna try scripts out before adding them to your repo\n- You want an easy way to add an alias/function/script for a limited time, say, while doing a demo\n\n## Install\n\n`shplug` currently officially supports `bash` and `zsh`:\n\n```\nsource \u003c(curl -L \"https://github.com/dtrugman/shplug/releases/download/v0.2.1/install\")\n```\n\n## Feature requests \u0026 Contributions\n\nYou are more than welcome to ask/do both!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtrugman%2Fshplug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdtrugman%2Fshplug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtrugman%2Fshplug/lists"}