tea is npx for everything.
$ node
command not found: node
$ brew install teaxyz/pkgs/tea-cli
# …
$ tea node --version
v19.7.0
$ node
command not found: node
# ^^ tea is not a package manager; keep installing shit w/`brew`
tea is nvm for everything:
$ cd my-project
$ cat .node-version
16
$ tea --env node --version
v16.20.1
$ source <(tea -E)
# temporarily adds `my-project`’s deps to your current shell
$ node --version
v16.20.1
$ which node
~/.tea/nodejs.org/v16.20.1/bin/node
# ^^ everything goes in ~/.tea
# use any version of anything
$ tea node@19 --version
v19.7.0
# we package as far back as we can
$ tea python=2.7.18 --version
Python 2.7.18this works for every dev-ecosystem, not just node, eg. we read
pyproject.toml,.ruby-version, etc.
PSA: Stop using Docker
Docker is great for deployment and cross compilation, but… let’s face it: it sucks for dev.
Docker stifles builders. It constricts you; you’re immalleable; tech marches onwards but your docker container remains immobile. Nobody knows how to use
docker. Once thatDockerfileis set up, nobody dares touch it.And let’s face it, getting your personal dev and debug tools working inside that image is incredibly frustrating. Why limit your potential?
Keep deploying with Docker, but use tea to develop.
Then when you do deploy you may as well install those deps with tea.
Frankly, tea is properly versioned (unlike system packagers) so with tea your deployments actually remain more stable.
tea knows how to interpret anything:
$ tea ./script.py
tea: installing ~/.tea/python.org/v3.11.1
# ^^ local scripts: nps
$ tea https://examples.deno.land/color-logging.ts
tea: installing ~/.tea/deno.land/v1.31.2
# ^^ remote scripts: also fineGo further; tap the entire open source ecosystem via YAML front matter:
$ cat favicon-generator.sh
#!/usr/bin/ruby
# ^^ tea reads the shebang and automatically installs ruby
#---
# dependencies:
# imagemagick.org: 4
# optipng.sourceforge.net: 1
#---
# …
$ tea favicon-generator.sh input.png
tea: installing image-magick, optipng, guetzli and 3 other packages…
$ file *.png
favicon-128.png: PNG image data, 128 x 128
favicon-32.png: …Setting the shebang to #!/usr/bin/env -S tea node is also fine.
Try out anything open source offers in an encapsulated sandbox:
$ tea +rust-lang.org sh
tea: this is a temporary shell containing rust-lang.org and 3 other pkgs
tea: type `exit` when done
tea $ rustc --version
rustc 1.65.0
tea $ exit
$ rustc
command not found: rustctea’s +pkg syntax adds packages to an environment and then executes
commands within it. This can make trying out seemingly complex projects
trivial, eg. setting up your environment for the stable-diffusion-webui
project can be quite tricky, but not so with tea:
$ git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui
$ tea \
--cd stable-diffusion-webui \
+python.org~3.10 +pip.pypa.io +gnu.org/wget +protobuf.dev +rust-lang.org \
./webui.sh
If you’re cool and you love cool stuff then tea can optionally make command
not found errors a thing of the past:
$ which node
command not found: node
$ source <(tea --magic)
$ node --version
tea: installing nodejs.org…
v19
$ node@16 --version
v16
$ node --version
v19 # the most recent is defaultOur magic also loads project deps into the environment when you step inside:
$ cd my-project
my-project $ cat .node-version
14
my-project $ node --version
tea: installing nodejs.org@14…
v14
my-project $ cd ..
$ node --version
v19
$ source <(tea --magic=unload)
$ node
command not found: node
brew install teaxyz/pkgs/tea-cliIf you prefer, tea is a standalone, cross-platform binary that you can install anywhere you want (releases). Here’s a handy one-liner:
sudo install -m 755 \
<(curl --compressed -LSsf https://tea.xyz/$(uname)/$(uname -m)) \
/usr/local/bin/teaBy itself tea works well, it’s just a little manual, but we’re all magic addicts and recommend it:
echo 'source <(tea --magic)' >> ~/.zshrcWith magic stepping into directories ensures the packages those projects need are installed on demand and available to the tools you’re using.
You want all the docs? We got all the docs. docs.tea.xyz
We appreciate your using tea and would love to help you solve any problems
you may be having.
Check out the pantry README.
If you have suggestions or ideas, start a discussion. If we agree, we’ll move it to an issue. Bug fixes straight to pull request or issue please!
tea is written in TypeScript using deno.
$ git clone https://github.com/teaxyz/cli tea
$ cd tea
deno task run foo
# ^^ runs the local checkout passing `foo` as an argument
$ deno task install
# ^^ deploys the local checkout into your `~/.tea`
$ deno task compile && ./tea