{"id":16843654,"url":"https://github.com/thornjad/zpico","last_synced_at":"2025-03-18T05:44:01.388Z","repository":{"id":114294937,"uuid":"379417079","full_name":"thornjad/zpico","owner":"thornjad","description":"The minuscule Zsh plugin manager","archived":false,"fork":false,"pushed_at":"2024-04-02T20:40:07.000Z","size":52,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-24T12:30:08.837Z","etag":null,"topics":["shell","zsh","zsh-configuration","zsh-plugins"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thornjad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"thornjad"}},"created_at":"2021-06-22T22:35:29.000Z","updated_at":"2025-01-03T07:12:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"dfc5cff6-9b92-4032-b483-6f2bf616a6db","html_url":"https://github.com/thornjad/zpico","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thornjad%2Fzpico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thornjad%2Fzpico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thornjad%2Fzpico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thornjad%2Fzpico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thornjad","download_url":"https://codeload.github.com/thornjad/zpico/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244166639,"owners_count":20409177,"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":["shell","zsh","zsh-configuration","zsh-plugins"],"created_at":"2024-10-13T12:52:40.078Z","updated_at":"2025-03-18T05:44:01.369Z","avatar_url":"https://github.com/thornjad.png","language":"Shell","funding_links":["https://github.com/sponsors/thornjad"],"categories":[],"sub_categories":[],"readme":"# ZPico\n\nThe minuscule zsh package manager. No frills, no bloat, just 4 kB of 100% Zsh code, providing complete package management for your Zsh environment.\n\nZsh package managers are abundant, but most are bloated, slow or have excessive requirements. On top of that, more than a few have been abandoned for years. Zpico does not seek to be the best of the best, rather to balance functionality against a tiny, fast footprint.\n\n## Installation\n\nRequires `git`.\n\n```\ncurl -sL --create-dirs https://raw.githubusercontent.com/thornjad/zpico/main/zpico.zsh -o $HOME/.local/lib/zpico/zpico.zsh\n```\n\nThen add `source $HOME/.local/lib/zpico/zpico.zsh` to your `.zshrc` and reload your shell.\n\n_This is the recommended installation path, but you can put it wherever you want._\n\n## Usage\n\n### Add packages\n\n`zpico add \u003cpackage-repo\u003e [[source:\u003csource\u003e] [branch:\u003cbranch\u003e] [use:\u003cglob\u003e]]`\n\nThis command downloads and initializes a given package. If the package has already been download, it initializes only. \n\nThe required argument `package-repo` is the package's repo in `\u003cgroup\u003e/\u003cproject\u003e` format (supports Gitlab subgroups with `source:gitlab`).\n\nThe optional argument `source:` determines the source domain to get the package from. Currently supports `github`, `gitlab`,  `framagit` and the special `local` (see [Local packages](#local-packages) below). If omitted, defaults to `source:github`.\n\nThe optional argument `branch` specifies the Git branch to use. If omitted, uses the default branch for the package (typically `master`, `main` or `trunk`).\n\nThe optional argument `use` specifies the file (or file pattern) to use.\n\n#### Other URL\n\nZpico can also load packages from arbitrary URLs.\n\n`zpico add \u003cpackage-url\u003e [branch:\u003cbranch\u003e]`\n\nThe optional argument `branch` works the same as specified above.\n\n#### Local packages\n\n`zpico add \u003cpackage-path\u003e source:local [branch:\u003cbranch\u003e]`\n\nThe optional argument `branch` works the same as specified above.\n\n### Other commands\n\nPrecede all commands with `zpico`.\n\n| command    | description                                                             |\n|------------|-------------------------------------------------------------------------|\n| update     | update all installed packages                                           |\n| selfupdate | update Zpico. Requires `curl`. Alternatively, reinstall Zpico to update |\n| clean      | remove all packages currently installed                                 |\n| help       | print help text                                                         |\n| version    | print version info                                                      |\n\n### Customize package installation path\n\nThe default package installation path is `~/.local/share/zpico/`. Customize this by setting `ZP_PLUGIN_HOME` prior to loading Zpico in your `~/.zshrc`.\n\n## Example\n\n```\n# ~/.zshrc\nsource ~/.local/lib/zpico/zpico.zsh\n\n# Packages\nzpico add nocttuam/autodotenv\nzpico add zdharma/zsh-diff-so-fancy\nzpico add thornjad/vero source:gitlab\n```\n\n## Uninstall\n\n```\nrm -rf ~/.local/lib/zpico ~/.local/share/zpico\n```\n\nReplace paths with the correct ones if you've customized them, then remove any Zpico-related commands from your `~/.zshrc`.\n\n## License\n\nCopyright (c) 2021-2023 Jade Michael Thornton\n\nSee [LICENSE](./LICENSE) for terms (it's the ISC license).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthornjad%2Fzpico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthornjad%2Fzpico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthornjad%2Fzpico/lists"}