pkgxdev /pkgx

Run Anything

★ 9,935⑂ 1,389👁 73⑃ 568● 466▤ 235
RustApache-2.0Created 2021-11-20pkgx.sh
Download: v2.11.0v2.11.0 ↓2.11.02026-07-22
+0
Daily
9,935
stars
1,389
forks
73
watchers
568
prs
466
issues
235
releases

README

!pkgx.dev

pkgx is a 4 MiB, standalone binary that can _run anything_.

[![coverage][]][coveralls] [![teaRank][]](https://tea.xyz)

 [!NOTE]

 You want your tools to _just work_ and we want that too. We pride ourselves
 on packaging things as well as possible because we want you to change the
 world with what you build and not have to worry about the rest.

 

 Quickstart

sh
brew install pkgx || curl https://pkgx.sh | sh


pwsh
 Windows 10+
irm https://pkgx.sh | iex
 ^^ we only have limited packages so far


 [docs.pkgx.sh/installing-w/out-brew]

 

 Run Anything

sh
$ deno
command not found: deno

$ pkgx deno
Deno 2.1.4
 ^D

$ deno
command not found: deno
 ^^ nothing was installed; your wider system is untouched


 Run _Any Version_ of Anything

sh
$ pkgx node@14 --version
Node.js v14.21.3

$ pkgx python@2 --version
Python 2.7.18


 Run Anywhere

macOS

- macOS = 11
- 64 bit Intel & Apple Silicon


Linux

- glibc =2.28 repology
- libgcc
- x86_64 & arm64

 Specifically these libs are needed:

 - libatomic.so.1 (provided by libgcc)
 - libdl.so.2 (provided by glibc)
 - libm.so.6 (provided by glibc)
 - libgcc_s.so.1 (provided by libgcc)
 - libpthread.so.0 (provided by glibc)
 - libc.so.6 (this _is_ glibc)
 - ld-linux-x86-64.so.2 (provided by the kernel, you get this for free)

 libgcc is built as part of the GCC distribution and usually is split out
 into multiple packages by the linux distribution. libgcc is almost always
 a separate package, but you may need to install gcc in its entirety.
 Sometimes libatomic is also a separate package rather than being part of
 gcc or libgcc.


Windows

- Experimental Windows native support (limited packages)
- WSL2 (everything Linux supports)


Docker

We provide an image with pkgx in it:

sh
$ pkgx docker run -it pkgxdev/pkgx

(docker) $ pkgx node@16
Welcome to Node.js v16.20.1.
Type ".help" for more information.



You can use this image to try out (pretty much) any version of any program:

sh
$ docker run pkgxdev/pkgx [email protected] --version
v21.1.0


Or in a Dockerfile:

Dockerfile
FROM pkgxdev/pkgx
RUN pkgx [email protected] task start


Or in any image:

Dockerfile
FROM ubuntu
RUN curl https://pkgx.sh | sh
RUN pkgx [email protected] -m http.server 8000



CI/CD

yaml
- uses: pkgxdev/setup@v4
- run: pkgx shellcheck


Or in other CI/CD providers:

sh
curl https://pkgx.sh | sh
pkgx shellcheck



Scripts

sh
!/usr/bin/env -S pkgx +git [email protected]

 python 3.12 runs the script and git is available during its execution


 [docs.pkgx.sh/scripts]


Editors

Use [dev][dev]; a separate tool that uses the pkgx primitives to
automatically determine and utilize your dependencies based on your project’s
keyfiles.

sh
$ cd myproj

myproj $ dev
+cargo +rust

myproj $ code .




 What Can pkgx Run?

We have a web based package listing at
pkgx.dev/pkgs.

From the CLI you can use query mode:

sh
$ pkgx -Q git
 ^^ can you run git? (outputs the fully qualified project name)

$ pkgx -Q
 ^^ list everything that could be run

$ pkgx -Q

Top issues

Discussions

Latest release

v2.11.0 v2.11.0 2026-07-22
What's Changed
 Bump rand from 0.9.2 to 0.9.4 by @dependabot[bot] in https://github.com/pkgxdev/pkgx/pull/1264
 Bump openssl from 0.10.72 to 0.10.78 by @dependabot[bot] in https://github.com/pkgxdev/pkgx/pull/1265
 Bump robinraju/release-downloader from 1.11 to 1.13 by @dependabot[bot] in https://github.com/pkgxdev/pkgx/pull/1266
 Bump openssl from 0.10.78 to 0.10.79 by @dependabot[bot] in https://github.com/pkgxdev/pkgx/pull/1268
 Bump openssl from 0.10.79 to 0.10.80 by @dependabot[bot] in https://github.com/pkgxdev/pkgx/pull/1270
 Bump actions/checkout from 6 to 7 by @dependabot[bot] in http

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON