Skip to main content

install

The proto install (or proto i) command can be used to install one or many tools.

Installing all toolsv0.39.0​

The proto install command (without arguments) will download and install all tools and plugins from all parent .prototools configuration files, and any versions detected in the current working directory (if not defined in .prototools).

$ proto install

By default, this command does not install tools for versions pinned in the global ~/.proto/.prototools file. Pass --config-mode all to include them.

Installing one tool​

The proto install <tool> [version] command will download and install a single tool by unpacking their archive to ~/.proto/tools/<tool>. If the tool has already been installed, the command will exit early.

The command is also smart enough to resolve partial versions, so 1, 1.2, and 1.2.3 are all acceptable. It even supports aliases when applicable, like latest, next, beta, etc. To install a canary release, use --canary.

$ proto install deno
$ proto install deno 1.31
$ proto install deno --canary

Pinning the version​

By default this command will only install the tool into ~/.proto/tools but will not make the binary available. If you would like to also pin the resolved version to a .prototools file, use the --pin option.

# ./.prototools
$ proto install bun --pin
$ proto install bun --pin local

# ~/.proto/.prototools
$ proto install bun --pin global

# ~/.prototools
$ proto install bun --pin user

Handling plugin hooks​

Some tools run post-install hooks that support arbitrary arguments that can be passed after --.

$ proto install go -- --no-gobin

Arguments​

  • [tool] - Type of tool.
  • [version] - Version of tool. Defaults to "latest".
  • [-- <args>] - Additional arguments to pass to post-install hooks.

Options​

  • force - Force install, even if already installed.
  • One
    • --build - Build from source if available. v0.45.0
    • --no-build - Download a pre-built if available. v0.45.0
    • --canary - Install a canary (next, nightly, etc) version.
    • --pin - Pin the resolved version and create a symlink in ~/.proto/bin. Accepts a boolean (pins locally by default), or the string "global", or the string "local".