DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk4 min

ZPico for Zsh: Install and Manage Plugins with a Focused Toolset

ZPico is a Git-dependent Zsh package manager with support for common Git hosts, local paths, and a focused set of install, update, and removal commands.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

ZPico is a small, Zsh-based package manager for installing and managing shell plugins and other Git-backed packages. Its documented workflow is straightforward: download the script, source it from .zshrc, then use zpico add, update, and remove. It suits users who want a focused command set; people who need richer plugin-management features may prefer a broader manager.

What ZPico does

ZPico is an open-source package manager implemented in Zsh. The project README describes it as “under 5 kB of 100% Zsh code”; that is the project’s own size description, not an independently measured benchmark. Git is its stated prerequisite. The project identifies its license as ISC. ZPico project README

As an Amazon Associate I earn from qualifying purchases.

It installs packages from supported Git hosts, arbitrary Git-cloneable URLs, and local paths. You can specify a branch and a file or glob pattern to load. Its documented management commands cover adding, updating, removing, self-updating, help, and version information.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How to install ZPico

The README recommends downloading the script into $HOME/.local/lib/zpico/ and sourcing it from .zshrc. Git is required. This command fetches the file from the repository’s moving main branch, so it is not a version-pinned installation.

mkdir -p "$HOME/.local/lib/zpico"
git clone https://github.com/thornjad/zpico.git /tmp/zpico
cp /tmp/zpico/zpico.zsh "$HOME/.local/lib/zpico/zpico.zsh"
echo 'source "$HOME/.local/lib/zpico/zpico.zsh"' >> "$HOME/.zshrc"

The README’s recommended setup downloads zpico.zsh from the project’s GitHub main branch; its precise documented command is available in the project README. The example above uses Git to retrieve the repository before copying the script. The README also says the script can be placed elsewhere; if you choose another location, source that path in .zshrc. Open a new shell or source your updated configuration to load it.

How to add packages

Use zpico add with a package in group/project form. GitHub is the default source when you omit a source. The README lists GitHub, GitLab, Framagit, Codeberg, local sources, arbitrary Git-cloneable URLs, and local package paths. GitLab subgroups use the explicit source:gitlab form. You can also select a branch and choose which file or glob pattern to load. Consult the README for the exact argument syntax supported by the current script.

Illustrative forms, rather than a guarantee that every package uses the same files, look like this:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
zpico add group/project
zpico add source:gitlab group/subgroup/project
zpico add group/project --branch branch-name --file 'plugin*.zsh'

Check the project documentation for the current option names and ordering before using branch or file-pattern arguments. The README supports those options but exact invocation details can change.

Where packages go and how to manage them

By default, ZPico stores packages in ~/.local/share/zpico/plugins/. To use another location, set ZP_PLUGIN_HOME before loading ZPico in your shell configuration.

export ZP_PLUGIN_HOME="$HOME/path/to/zpico-packages"
source "$HOME/.local/lib/zpico/zpico.zsh"

The documented command set is:

  • zpico add to install a package.
  • zpico remove <pkg> to remove one, or zpico remove --all to remove all packages.
  • zpico update <pkg> to update one, or zpico update --all to update all packages.
  • zpico selfupdate to update ZPico itself; the README says this requires curl or manual reinstallation.
  • zpico help and zpico version for help and version information.

To uninstall, remove the ZPico script and package directory, then delete ZPico-related lines from .zshrc. If you changed ZP_PLUGIN_HOME, remove the package directory you configured instead of assuming the default path.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Is ZPico a better fit than a broader manager?

That depends on whether you value a narrow toolset or features that cover more of a Zsh setup. The comparison below is based on the projects’ documentation, not controlled performance testing.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Tool Documented emphasis Useful when
ZPico Small Zsh-only implementation, source flexibility, and a short set of package-management commands. Its “under 5 kB” description is the project’s own claim. You want package installation and basic updates or removals without a broader documented feature set.
zplug Its repository describes management for plugins, commands, themes, multiple source types, lazy loading, hooks, dependencies, and caching. zplug repository You need more configuration and plugin lifecycle features in one manager.
Zi Its package guide documents reusable package profiles, declared prerequisites, and installation or update hooks. Z-Shell Package guide You want package recipes and lifecycle behavior that go beyond a minimal add/update/remove workflow.

These documented feature differences do not establish which tool is faster. The available information does not provide a controlled, directly comparable ZPico performance benchmark.

Review packages before installing them

A package manager can install code that runs in your shell environment. The Z-Shell package guide advises reviewing package recipes and their requirements before running them, because recipes can execute commands in the user’s environment. This is general package-management caution, not evidence of a specific security flaw in ZPico. Z-Shell Package guide

What is known about releases and maintenance

The repository page identifies the public thornjad/zpico project and links to commit history and tags, but the project information reviewed does not establish a reliable latest-commit or release date. That is not enough to label ZPico either actively maintained or abandoned. Check its current repository history and tags if release recency matters to your decision.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.