Installation

Complete installation guide for all packages in this tap.

Choose Your Package

This tap provides three packages:

• k3d-local – Local Kubernetes cluster management
• promptx – Prompt intelligence CLI with encrypted memory and web UI
• vaultx – Zero-trust encrypted secrets CLI with web UI

You can install any combination.

Homebrew (macOS / Linux)

Add Tap

brew tap gautampachnanda101/tap

Install Packages

brew install k3d-local
brew install promptx
brew install vaultx

# Or install multiple at once
brew install k3d-local promptx vaultx

Upgrade

brew upgrade k3d-local
brew upgrade promptx
brew upgrade vaultx
brew upgrade             # Upgrade all

Uninstall

brew uninstall k3d-local
brew uninstall promptx
brew uninstall vaultx
brew untap gautampachnanda101/tap  # Optional: remove tap entirely

Windows

Scoop Installation

All three tools are available via Scoop:

# Add scoop bucket
scoop bucket add promptx https://github.com/gautampachnanda101/scoop-bucket

# Install
scoop install promptx
scoop install k3d-local
scoop install vaultx

Upgrade

scoop update promptx
scoop update k3d-local
scoop update vaultx

Manual Installation (All Platforms)

Download binaries directly from GitHub Releases:

# Download latest release (Linux x86_64 example)
curl -L https://github.com/gautampachnanda101/homebrew-tap/releases/download/v0.1.0-rc59/promptx_Linux_x86_64.tar.gz \
  -o promptx.tar.gz

# Extract
tar xzf promptx.tar.gz

# Move to PATH
sudo mv promptx /usr/local/bin/
chmod +x /usr/local/bin/promptx

# Verify
promptx --version

Available archives for each release: - promptx_Darwin_x86_64.tar.gz (macOS Intel) - promptx_Darwin_arm64.tar.gz (macOS Apple Silicon) - promptx_Linux_x86_64.tar.gz (Linux Intel) - promptx_Linux_arm64.tar.gz (Linux ARM) - k3d-local_*_*.tar.gz (all platforms)

k3d-local Installation

macOS/Linux Homebrew

brew tap gautampachnanda101/tap
brew install k3d-local

Platform-Specific Notes

macOS (Apple Silicon & Intel)

Homebrew automatically detects your architecture:

brew install k3d-local  # Correct version is auto-selected

Verify:

k3d-local --version

Linux

Supported distributions: - Ubuntu 20.04+ - Debian 11+ - Fedora 34+ - CentOS 8+ - Any with glibc 2.31+

Via Homebrew/Linuxbrew:

brew tap gautampachnanda101/tap
brew install k3d-local

Manual installation:

# Download
curl -L https://github.com/gautampachnanda101/homebrew-tap/releases/download/v1.0.5/k3d-local_1.0.5_Linux_x86_64.tar.gz \
  -o k3d-local.tar.gz

# Extract and install
tar xzf k3d-local.tar.gz
sudo mv k3d-local /usr/local/bin/
chmod +x /usr/local/bin/k3d-local

# Verify
k3d-local --version

Dependencies for k3d-local

Required: - Docker 20.10+

Optional (auto-installable with --auto-install): - k3d 5.8.3+ - kubectl 1.25+ - helm 3.0+

Install dependencies manually:

macOSLinux (Ubuntu/Debian)Linux (Fedora/CentOS)Windows (Scoop)

brew install --cask docker
brew install kubectl helm k3d

sudo apt-get update
sudo apt-get install -y docker.io kubectl helm
curl -s https://raw.githubusercontent.com/k3d-io/k3d/main/install.sh | bash

sudo dnf install -y docker kubectl helm
curl -s https://raw.githubusercontent.com/k3d-io/k3d/main/install.sh | bash

scoop install docker kubectl helm k3d

Promptx Installation

macOS/Linux Homebrew

brew tap gautampachnanda101/tap
brew install promptx

Windows (Scoop)

scoop bucket add promptx https://github.com/gautampachnanda101/scoop-bucket
scoop install promptx

VS Code Extension (All Platforms)

After installing Promptx, install the VS Code extension:

macOS/Linux:

code --install-extension $(brew --prefix)/share/promptx/promptx-vscode-*.vsix

Windows:

code --install-extension "$env:USERPROFILE\scoop\apps\promptx\current\promptx-vscode-*.vsix"

Manual: Extract the release archive and run:

code --install-extension promptx-vscode-*.vsix

First-Run Setup

After installation, initialize Promptx:

promptx setup

This creates: - Encrypted vault for memory storage - Local passkey for encryption - MCP registration for IDE integrations - Background memory watch daemon

Verify:

promptx doctor
promptx machine verify

Vaultx Installation

Homebrew (macOS/Linux):

brew tap gautampachnanda101/tap
brew install vaultx

Windows (Scoop):

scoop bucket add promptx https://github.com/gautampachnanda101/scoop-bucket
scoop install vaultx

Initialize and open the web UI at http://127.0.0.1:7474/:

vaultx init
vaultx unlock
vaultx serve
open http://127.0.0.1:7474/

First-Run Setup

k3d-local

Create your first cluster:

# Option 1: Auto-install missing dependencies
k3d-local create --auto-install --with-traefik --with-apps

# Option 2: Manual (dependencies already installed)
k3d-local create --with-traefik --with-apps

See Getting Started for details.

Promptx

Initialize and start capturing:

# Initialize vault
promptx setup

# Start memory capture
promptx memory-watch --repo . --interval 5 --force-store

# Verify setup
promptx doctor

See Promptx Guide for details.

Vaultx

Initialize vault and start using:

vaultx init
vaultx unlock
vaultx serve    # open http://127.0.0.1:7474/ for the web UI

See Vaultx Guide for details.

Troubleshooting Installation

Command Not Found

If any tool is not recognized after install:

# Check if installed
which k3d-local
which promptx
which vaultx

# Reload shell
exec $SHELL

# Check Homebrew
brew --prefix k3d-local
brew --prefix promptx
brew --prefix vaultx

# Check PATH
echo $PATH

Version Conflicts

Check installed versions:

brew list k3d-local
brew list promptx

k3d-local --version
promptx --version

Platform-Specific Issues

macOS ARM64 (Apple Silicon):

Ensure you're on Homebrew ARM build:

brew --version
arch  # Should show arm64

Linux glibc version:

Check system glibc:

ldd --version

Ensure 2.31 or higher for Linux binaries.

Still Having Issues?

1. Run diagnosis:

   promptx doctor
   promptx machine verify
   

2. Check troubleshooting guides:

3. k3d-local Troubleshooting

4. Promptx Guide - Troubleshooting

5. Report issues:

6. GitHub Issues