pkgxdev / pkgx Goto Github PK

View Code? Open in Web Editor NEW

8.7K 79.0 1.4K 1.33 MB

the last thing you’ll install

Home Page: https://pkgx.sh

License: Apache License 2.0

TypeScript 98.06% Shell 1.86% Ruby 0.07%

package-manager environment-manager package-runner

pkgx's Introduction

pkgx is a single, standalone binary that can run anything.

Quickstart

brew install pkgxdev/made/pkgx

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

Migrating from v0

Run Anything

$ deno
command not found: deno

$ pkgx deno
Deno 1.36.3
> ^D

$ deno
command not found: deno
# ^^ nothing was installed; your system remains untouched

Run Any Version of Anything

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

$ pkgx python@2 --version
Python 2.7.18

Run Anywhere

macOS
- macOS >= 11
- x86-64 & Apple Silicon
Linux
- glibc >=2.28 repology
- x86_64 & arm64
Windows

WSL2; x86-64. Native windows is planned.

Docker

$ pkgx docker run -it pkgxdev/pkgx

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

Or in a Dockerfile:

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

Or in any image:

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

docs.pkgx.sh/docker

CI/CD

- uses: pkgxdev/setup@v1
- run: pkgx shellcheck

Or in other CI/CD providers:

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

docs.pkgx.sh/ci-cd

Scripts

#!/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
```
$ cd myproj

myproj $ env +cargo
(+cargo) myproj $ code .
```
Or use dev; a separate tool that uses the pkgx primitives to automatically determine and utilize your dependencies based on your project’s keyfiles.
```
$ cd myproj

myproj $ dev
env +cargo +rust

(+cargo+rust) my-rust-project $ code .
```
docs.pkgx.sh/editors

Shell Integration

pkgx puts the whole open source ecosystem at your fingertips and its optional shell integration makes workflows with that open source even more seamless.

$ env [email protected]    # do `pkgx integrate --dry-run` first
added ~/.pkgx/go.dev/v1.16 to environment

(+go) $ go
Go is a tool for managing Go source code.
#…

(+go) $ env | grep go
PATH=~/.pkgx/go.dev/v1.16.15/bin:$PATH
LIBRARY_PATH=~/.pkgx/go.dev/v1.16.15/lib

(+go) $ env -go
removed ~/.pkgx/go.dev/v1.16 from environment

$ go
command not found: go

Tools are available for the duration of your terminal session. If you need them for longer, eg. pkgx install go.

docs.pkgx.sh/shell-integration
docs.pkgx.sh/pkgx-install

`dev`

dev is a separate tool that leverages pkgx's core features to auto-detect and install project dependencies, seamlessly integrating them into your shell and editor.

my-rust-proj $ dev    # do `pkgx integrate --dry-run` first
dev: found Cargo.toml; env +cargo +rust

(+cargo+rust) my-rust-proj $ cargo build
Compiling my-rust-proj v0.1.0
#…

The dev tool requires our shell integration to work.

docs.pkgx.sh/dev

Getting Started

brew install pkgxdev/made/pkgx

no brew? docs.pkgx.sh/installing-w/out-brew

Integrating with your Shell

pkgx integrate --dry-run   # docs.pkgx.sh/shell-integration

Contributing

To add packages see the pantry README
To hack on pkgx itself; clone it and then pkgx deno task to list entrypoints for hackers

If you have questions or feedback:

github.com/orgs/pkgxdev/discussions
x.com/pkgxdev (DMs are open)

pkgx's People

Contributors

Stargazers

Watchers

Forkers

jonchang rysiman keith zohairhadi joshleblanc abitrolly dysthymia alexliu007 davidtai kohlerm benjaminbours marcussorealheis romarioext calvinjolly rickychez nihilsupernum renderlynx carolinier alysanyan tlanderon mattwhew devinhpbr webnetjoker archmsc ytochkaaa villarael alezz1x freytara dremling jonygel uthersunlighter mitchelnode tverzh tempgrox joelryyolo kretood robsberrry oldenzel creeptocat nevermoreover northtrend ruthwright free1ander ohhkaneda testnet25 cronusman twan777 andrewwshka notasandman andreassav goldentorrent vgjtsy vgk88 captainfantastic123 chiraggandhi123 hezhizhen branchvincent bpartridge askagirl jackydai-bc darkpiv hummusonrails positioner teezzan dio magnusviri uncommon-dev alipostaci2001 mbrukman datta-magar ela1998 jakenvac duydo markusbkk karaz-debug zegl miles170 pedrocruzio testevgen otherjl0 mfts strogo lino-levan amit-62 erdem4663 qinglin89 houzijiejie ethvs btbt520 bt520 duxin0817060114 wi212186971 stanlebowski slashyanyan ersaproudman jonytoweb3 sjontinwe duoduo1105 vzariona nelia09575705

pkgx's Issues

binaries for aarch64 Mac attached to the tea releases don’t run

It's a code signing issue or something. Sigh.

-rc1 version masquerades as release

https://github.com/Kitware/CMake/releases

v3.24.0-rc1 makes us think that we can build v3.24.0, but then we 404 on download.

`usePantry.git.ts` flock can make tea hang

the filesystem lock is outside of our process. We need to catch signals and unlock and also be able to recover from not unlocking because our process was killed unceremoniously.

tea.xyz 0.8.2 throws missing hugo command error in staging GHAction teaxyz/setup@v0

Error Example: https://github.com/teaxyz/www/actions/runs/3255802342/jobs/5345516440

But 0.8.1 is ok: https://github.com/teaxyz/www/actions/runs/3253330508/jobs/5340498384

More Efficient Downloads

Stream downloads into the SHA256 digest function AND write to file.
- in useDownload.ts
Download the checksum file simultaneously (async/await)
when download is complete compare the two shas (this already happens)

If there’s a `VERSION` file, coerce the version out of it

Eg. go.dev has a VERSION file that contains eg. go1.18.3

lint step that errors if any `console.log` is left in NON DRAFT prs

error for:

any use of console.log
failing to await a promise inside an if statement

GPG sign GitHub Action created releases

Store the key securely. (@Xercesblu3 to research this)
@jhheider to implement

Longer term storing the key in as a GitHub Secrets is not sufficient and we will need to determine something better.

Longer term we will need releases to be approved via a push notification to the devices of @mxcl and @jhheider, this will pause the actions run waiting on that in some manner.

go demo is missing

$ tea https://github.com/teaxyz/demos/blob/main/demo.go input.txt
tea: demo.go downloading
error: Uncaught (in promise) Error: 404: https://raw.githubusercontent.com/teaxyz/demos/main/demo.go
                throw new Error(`${rsp.status}: ${src}`);
                      ^
    at internal (file:///opt/tea.xyz/src/v0.11.4/src/hooks/useDownload.ts:75:23)
    at async Object.download (file:///opt/tea.xyz/src/v0.11.4/src/hooks/useDownload.ts:81:12)
    at async file:///opt/tea.xyz/src/v0.11.4/src/app.exec.ts:120:26
    at async abracadabra (file:///opt/tea.xyz/src/v0.11.4/src/app.exec.ts:115:18)
    at async exec (file:///opt/tea.xyz/src/v0.11.4/src/app.exec.ts:12:57)
    at async file:///opt/tea.xyz/src/v0.11.4/src/app.ts:29:9

Installer fails after terminal with temporarily run tea

It seems that in the case I run a temporary tea invocation from the readme, and then the installer, the installer fails:

% sh <(curl tea.xyz) +rust-lang.org
######################################################################################################################################################################################### 100.0%
  k, we installed  /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/tea.xyz/v0.11.4/bin/tea

tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/gnome.org/libxml2/v2.10.3
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/openssl.org/v1.1.118
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/gnu.org/gettext/v0.21.1
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/curl.se/v7.86.0
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/perl.org/v5.36.0
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/tea.xyz/gx/cc/v0.1.0
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/zlib.net/v1.2.13
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/git-scm.org/v2.38.1
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/rust-lang.org/v1.64.0
tea: installed: /var/folders/9x/pr1hvj4n16dgxh9sxy5gg2pm0000gp/T/tea-XXXXXX.TqvyDNYj/rust-lang.org/cargo/v0.65.0
this is a temporary shell containing the following packages:
gnome.org/[email protected], [email protected], gnu.org/[email protected], [email protected], [email protected], tea.xyz/gx/[email protected], [email protected], [email protected], [email protected], rust-lang.org/[email protected]
when done type: `exit'

% sh <(curl https://tea.xyz)
######################################################################################################################################################################################### 100.0%
/dev/fd/14: line 173: tea: command not found
/dev/fd/14: line 173: tea: command not found

To get the installer actually working I have to create a new terminal and run it again. This is on macOS ventura.

I guess I'm in a nested session here where I should exit, and then install, but ideally this would "just work"

Incorrect env Set When Moving Directories

Moving from one env to another doesn’t set that env correctly

inside venv, `tea --help` lists available targets

Explicit package versions don't constrain existing installs

How do we specify a specific version of a package? I can't find this documented anywhere. I tried a few things and I think the character is "~" because when I use that it at least generates an error (my other guess, "@", doesn't generate an error).

> tea +python.org~v3.10 python
error: Uncaught Error: invalid semver range: ~v3.10
                if (!match) throw new Error(`invalid semver range: ${input}`);
                                  ^
    at file:///opt/tea.xyz/src/v0.13.0/src/utils/semver.ts:153:35
    at Array.map (<anonymous>)
    at new Range (file:///opt/tea.xyz/src/v0.13.0/src/utils/semver.ts:106:56)
    at Module.parse (file:///opt/tea.xyz/src/v0.13.0/src/utils/pkg.ts:32:28)
    at useArgs (file:///opt/tea.xyz/src/v0.13.0/src/hooks/useFlags.ts:51:30)
    at file:///opt/tea.xyz/src/v0.13.0/src/app.ts:11:44

However, it doesn't work either.

> tea +python.org~3.10 python
Python 3.11.0 (main, Oct 29 2022, 23:30:44) [Clang 14.0.0 (clang-1400.0.29.102)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>
> tea --version
tea 0.13.0

Creating environments for python packages?

Can I tea +pip.pypa.io pip install Y to a different environment than tea +pip.pypa.io pip install X? It looks like right now they're all installed in ~/.tea/python.org/v3.11.0/lib/python3.11/site-packages. It would be great if I can separate them.

tea REPL should be clearly a tea REPL

possibly: export PS1=${PS1%%}- tea-REPL %

Resumable, parallel downloads

~~Currently we stream downloads to final dst and this means the file is corrupt if the download fails. Generally we assume the file existing means it is cool so it breaks shit.~~

No, actually, we want *resumable downloads.

Open Terminal on Copy

We need an app developed/installed to the tea/cli to automatically open the terminal via the user’s web browser (tea www) when they click-to-copy the tea one-liner. The one-liner should be automatically pasted/entered into the terminal upon starting. Currently, the tea/cli asks users if they would like to install tea via a y/n question. If this could be bypassed, that would better ensure an install, but will defer to mxcl. Not giving devs an options may piss them off.

The imperative of this is two fold:

we ensure more installs from marketing efforts/page visits
we are able to confirm that a btn-click on www equates to an install (this will help Gypsy to determine which ad channels are performing best)

Error for unknown arguments if `--strict`, warning if `--strict=no`, no output if `--quiet`

tea command doesn't execute python scripts

The README says tea can be used to run scripts, it it doesn't work.


➜  stable-diffusion git:(main) ls
LICENSE                           ldm
README.md                         main.py
Stable_Diffusion_v1_Model_Card.md models
assets                            notebook_helpers.py
configs                           scripts
data                              setup.py
environment.yaml
➜  stable-diffusion git:(main) tea setup.py
tea: command not found: setup.py
➜  stable-diffusion git:(main)

fuzzy string match for incorrect pkg-specs

For example:

$ tea +node-js.org

Should error with the suggestion of +nodejs.org.

Error split tea: panic:invalid absolute path:

On macOS 13 arm64, zsh, node version v16.18.0 I get the following error when trying to run the example directly after installing (sh <(curl tea.xyz)). It told me that I have to report the bug, so here you go 😆 Do you have any hint on how I can debug this? Thanks!

❯ tea +gnu.org/wget wget -qO- tea.xyz/white-paper | tea +charm.sh/glow glow -
tea: installed: ~/.tea/openssl.org/v1.1.118
tea: installed: ~/.tea/gnu.org/wget/v1.21.3

panic: split tea. we’re sorry and we’ll fix it… but you have to report the bug!

    https://github.com/teaxyz/cli/issues/new?title=panic%3Ainvalid+absolute+path%3A+.

----------------------------------------------------->> attachment begin
Error: invalid absolute path: .
    at new Path (file:///opt/tea.xyz/src/v0.11.13/src/vendor/Path.ts:38:19)
    at find_tea (file:///opt/tea.xyz/src/v0.11.13/src/hooks/useShellEnv.ts:177:22)
    at useShellEnv (file:///opt/tea.xyz/src/v0.11.13/src/hooks/useShellEnv.ts:89:29)
    at exec (file:///opt/tea.xyz/src/v0.11.13/src/app.exec.ts:18:32)
    at async file:///opt/tea.xyz/src/v0.11.13/src/app.ts:29:9
<<------------------------------------------------------ attachment ends
tea: installed: ~/.tea/charm.sh/glow/v1.4.1

panic: split tea. we’re sorry and we’ll fix it… but you have to report the bug!

    https://github.com/teaxyz/cli/issues/new?title=panic%3Ainvalid+absolute+path%3A+.

----------------------------------------------------->> attachment begin
Error: invalid absolute path: .
    at new Path (file:///opt/tea.xyz/src/v0.11.13/src/vendor/Path.ts:38:19)
    at find_tea (file:///opt/tea.xyz/src/v0.11.13/src/hooks/useShellEnv.ts:177:22)
    at useShellEnv (file:///opt/tea.xyz/src/v0.11.13/src/hooks/useShellEnv.ts:89:29)
    at exec (file:///opt/tea.xyz/src/v0.11.13/src/app.exec.ts:18:32)
    at async file:///opt/tea.xyz/src/v0.11.13/src/app.ts:29:9
<<------------------------------------------------------ attachment ends

allow script input from stdin

eg. this should work:

$ tea +rust-lang.org^1.2 rustc <<-HEREDOC
    println!("Hello World!");
HEREDOC

Implementation details:

rustc should receive the stdin, we should not write out the script for it

panic:Not a directory (os error 20), stat '/usr/local/bin/php/git

Error: Not a directory (os error 20), stat '/usr/local/bin/php/git'
    at Object.statSync (deno:runtime/js/30_fs.js:322:9)
    at Path.isFile (file:///opt/tea.xyz/src/v0.11.10/src/vendor/Path.ts:100:25)
    at Path.isExecutableFile (file:///opt/tea.xyz/src/v0.11.10/src/vendor/Path.ts:119:19)
    at find_git (file:///opt/tea.xyz/src/v0.11.10/src/hooks/useSync.ts:12:18)
    at install (file:///opt/tea.xyz/src/v0.11.10/src/hooks/useSync.ts:64:27)
    at update (file:///opt/tea.xyz/src/v0.11.10/src/hooks/useSync.ts:145:18)
    at file:///opt/tea.xyz/src/v0.11.10/src/app.ts:25:15

System Info

macOS Ventura - 13.0
ZSH Shell
Use Mackup for dot file/app prefs backups, but .tea not currently symlinked
Python environments are run via pyenv

Additional Notes

Initially I attempted to install v0.11.4 but that never prompted for the symlink for tea to be added. I first installed v0.11.10 just by running the install command, but to make sure I wasn't using anything that could have conflicted, I deleted the .tea folder and reset .zhsrc and deleted the symlink and then reinstalled again.

It mentions that it is preinstalling the pantries, but running tea -S is what causes this issue above, and if I try and run tea +gnu.org/wget wget -qO- tea.xyz/white-paper | tea +charm.sh/glow glow - I get the following:

error: not-found in pantry: charm.sh/glow/package.yml (spilt-tea-101)
your time to shine? we’ll see you on GitHub…

    https://github.com/teaxyz/pantry.extra#how-to-contribute
error: not-found in pantry: gnu.org/wget/package.yml (spilt-tea-101)
your time to shine? we’ll see you on GitHub…

    https://github.com/teaxyz/pantry.extra#how-to-contribute

Example not working

sh <(curl tea.xyz) https://github.com/teaxyz/cli

Is returning

error: http (spilt-tea-404)
400: https://raw.githubusercontent.com/teaxyz/cli

While in the README.md we can see this written.

Build cli For aarch On Releases

Build tea/cli for aarch platforms on tea/cli releases

panic:null

I tried to run tea . in this repo I just cloned.

Running on MacOs M1 ship.

I'm just approaching the project, cannot really provide more info so far.

tea .

panic: split tea. we’re sorry and we’ll fix it… but you have to report the bug!

    https://github.com/teaxyz/cli/issues/new?title=panic%3Anull

----------------------------------------------------->> attachment begin
null
<<------------------------------------------------------ attachment ends

Unreachable Code Preventing Short Circuit

While helping Montek with an error:

I discovered that this error which should be triggering when there's no commands in the README.md is unreachable:
https://github.com/davidtai/cli/blob/04a93c00750eb73bb35cd60a220ef42ffdcfe46a/src/app.exec.ts#L117

a check for } else if (args.length == 0) { is nested inside a check for if (env && args.length) { and therefore can never execute. Enabling this error makes Montek's scenario fail gracefully, however it breaks other common scenarios. More research is needed for a fix.

use `sandbox-exec` on macOS to restrict writes to TEA_PREFIX

Version logic can defeated by... weirdness

useGitHubAPI().getVersions() doesn't like this. I can't say I blame it. Need some logic to work around that.

Currently, ... scripts/build.ts ninja-build.org@1 works fine, but this kind of nonsense will happen elsewhere.

Store etag So Downloads Use Cache

store and use etag in useDownload() so github.com downloads use cache

Environment Variables are not passed through

Deno.run() doesn't pass through stuff so eg. TEA_PREFIX gets lost if set.

We need an exec anyway maybe we should just implement it.

Need linting when incorrectly not using `await` with `async` function

Too easy to do and not easy to spot.

We're not updating versions.txt for ourselves

Need to do that in cd.yml.

Specify custom or local distribution

I'm working on creating a package (isc.org/dhcp). I would like to create a REPL with the dependencies that my package requires so that I can debug the build commands. I don't know if there is a way to do this already, but I kind of instinctively thought the following might work, but it didn't (the error is shown).

# tea +isc.org/dhcp
error: http (spilt-tea-404)
404-not-found: https://dist.tea.xyz/isc.org/dhcp/linux/aarch64/versions.txt

Is there a way I can open a REPL with the dependencies that my local package requires? Maybe instead of tea +isc.org/dhcp I could do something like tea +file://path_to/isc.org/dhcp?

zsh completion for `tea +pkg`

The results can be obtained with:

cd $(tea --prefix)/tea.xyz/var/pantry/projects
find * -name package.yml -type f -exec dirname {} \;

When `tea` is a local checkout stepping into directories with `deno.json` have side effects

running make on the whitepaper didn't respond as expected

➜  ~ cd white-paper 
➜  white-paper git:(main) make
pandoc \
	--number-sections \
	--output tea.white-paper.pdf \
	--metadata-file metadata.yml \
	--filter pandoc-crossref \
	--csl=tea.csl \
	--citeproc \
	white-paper.md
make: pandoc: No such file or directory
make: *** [tea.white-paper.pdf] Error 1
➜  white-paper git:(main) tea make
error: Uncaught (in promise) Error: 404-not-found: https://dist.tea.xyz/pandoc.org/darwin/aarch64/versions.txt
    if (!rsp.ok) throw new Error(`404-not-found: ${url}`) //FIXME
                       ^
    at Object.select (file:///opt/tea.xyz/src/v0.11.6/src/hooks/useInventory.ts:7:24)
    at async resolve (file:///opt/tea.xyz/src/v0.11.6/src/prefab/resolve.ts:18:29)
    at async install (file:///opt/tea.xyz/src/v0.11.6/src/app.exec.ts:63:17)
    at async exec (file:///opt/tea.xyz/src/v0.11.6/src/app.exec.ts:13:27)
    at async file:///opt/tea.xyz/src/v0.11.6/src/app.ts:29:9
➜  white-paper git:(main) tea .
error: Uncaught (in promise) Error: 404-not-found: https://dist.tea.xyz/pandoc.org/darwin/aarch64/versions.txt
    if (!rsp.ok) throw new Error(`404-not-found: ${url}`) //FIXME
                       ^
    at Object.select (file:///opt/tea.xyz/src/v0.11.6/src/hooks/useInventory.ts:7:24)
    at async resolve (file:///opt/tea.xyz/src/v0.11.6/src/prefab/resolve.ts:18:29)
    at async install (file:///opt/tea.xyz/src/v0.11.6/src/app.exec.ts:63:17)
    at async exec (file:///opt/tea.xyz/src/v0.11.6/src/app.exec.ts:13:27)
    at async file:///opt/tea.xyz/src/v0.11.6/src/app.ts:29:9
➜  white-paper git:(main)

MacOS Bottle Preference

Prefer xz bottles on macOS

`curl dist.tea.xyz` should download the latest tea.xyz tarball

We have this in the README it's a neat idea.

Needs a lambda on our cloudfront to do it, and it should only do it for cURL so we can provide the web listing for the whole of dist.tea.xyz like I keep asking @jhheider to do.

invalid peer certificate: UnknownIssuer

Just installed tea and facing this error while I try to install any package

tea +openssl.org
error: http (spilt-tea-404)
error sending request for url (https://dist.tea.xyz/openssl.org/darwin/aarch64/versions.txt): error trying to connect: invalid peer certificate contents: invalid peer certificate: UnknownIssuer

sh <(curl tea.xyz) +nodejs.org
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8739  100  8739    0     0  14750      0 --:--:-- --:--:-- --:--:-- 14938
error: http (spilt-tea-404)
error sending request for url (https://dist.tea.xyz/unicode.org/darwin/aarch64/versions.txt): error trying to connect: invalid peer certificate contents: invalid peer certificate: UnknownIssuer

seems like its not able to validate server certificate against a root certificate from the trust store.
How can I disable ssl check?

tea REPL doesn't like /bin/bash

Interestingly, even running it in zsh fails if env.SHELL = /bin/bash.

$ echo $SHELL
/bin/bash
$ tea +nodejs.org
this is a temporary shell containing the following packages:
[email protected], [email protected], [email protected], [email protected], [email protected]
when done type: `exit'
/bin/bash: --interactive: invalid option
Usage:	/bin/bash [GNU long option] [option] ...
	/bin/bash [GNU long option] [option] script-file ...
GNU long options:
	--debug
	--debugger
	--dump-po-strings
	--dump-strings
	--help
	--init-file
	--login
	--noediting
	--noprofile
	--norc
	--posix
	--pretty-print
	--rcfile
	--restricted
	--verbose
	--version
Shell options:
	-ilrsD or -c command or -O shopt_option		(invocation only)
	-abefhkmnptuvxBCEHPT or -o option

Better `.checksums` file

Store checksums in a single file checksums in the www directory
- There is a standard format for this
If files to be downloaded are already downloaded (except checksums, ALWAYS download the checksums)
- Do the If Modified Since check
- If not modified fetch the checksum file anyway and compare from disk

`npm` versioning woe

npm ships with node but is versioned independently.

We control versions, so we should patch it to not prompt the user to run npm i -g npm@latest to update it, (instead prompting them to use tea update npm (where update will be a teaxyz/cmd cmd-fork).
How do we handle it otherwise? Perhaps:
- Make it npmjs.org with separate versioning
- Don't bundle it with nodejs.org
- But make it a recommended dependency that is, by default, installed with nodejs.org

change useOffLicense type Type = 's3' | 'ipfs', and add appropriate logic to the two functions
add a useRepository hook and change useCache.ts/install.ts to use its .download() function
use S3 as a fallback if .ipfs file is not found or if the path errors/404s

sh <(curl tea.xyz)
tea +git-scm.org git clone https://github.com/teaxyz/www tea-www
cd tea-www
tea .

I get an issue with temporary files:

dtai@Striker-Noir:~/projects/tea-www$ tea -vvv .
{
  args: { args: [ "." ], pkgs: [] },
  flags: {
    verbosity: 3,
    magic: true,
    json: false,
    numpty: false,
    sync: false,
    verbose: true,
    debug: true,
    muggle: false,
    silent: false
  }
}
/home/dtai/.tea/tea.xyz/v0.11.6/bin/tea
error: Uncaught (in promise) "file-exists:/home/dtai/.tea/tea.xyz/tmp/tea1ebdbfb5"

This occurs in WSL Ubuntu and OSX.