The pkgx module provides an interface for the pkgx tool runner, enabling users to fetch and run any open-source utility on-the-fly. It solves the "versioning" and "immediate availability" problems for developers.
When to Activate
- When the user wants to run a tool once without installing it globally.
- When testing a specific version of a software (e.g.,
bun@1.0). - When adding temporary tools to the current execution environment.
Core Principles & Rules
- Non-Invasive: Runs tools without modifying the system's PATH or global configuration.
- Immediate Execution: Use
+pkgto temporarily inject a tool into the environment for a specific command. - Zero-Setup: Automatically handles tool acquisition and execution.
Patterns & Examples
Run Without Installation
# Execute bun without installing it to the system
x pkgx bun --eval 'console.log("hello world")'
Temporary Environment Injection
# Temporarily add fzf to the current environment to run a command
eval "$(x pkgx +fzf)"
Interactive Browsing
# Browse all available packages in the pkgx ecosystem
x pkgx ls
Checklist
- Confirm if the tool is for one-off use or permanent installation.
- Verify if a specific version of the tool is required.
- Ensure the user is aware that the environment is not permanently modified.