Getting Started¶
Get up and running with homebrew-tap tools in 5 minutes.
This tap provides three tools:
- k3d-local – Local Kubernetes development environment
- promptx – Prompt intelligence CLI with encrypted memory and web UI
- vaultx – Zero-trust encrypted secrets CLI with web UI
Choose the tool(s) you want to use to get started.
k3d-local: Local Kubernetes¶
Get up and running with k3d-local in 5 minutes.
Requirements¶
A modern system with:
- macOS 10.14+, Linux (most distributions), or Windows 10+
- Docker or Docker Desktop pre-installed
- Internet connection (for initial downloads)
Note
Other dependencies (k3d, kubectl, helm) can be automatically installed using the --auto-install flag.
Install k3d-local¶
brew tap gautampachnanda101/tap
brew install k3d-local
For detailed platform-specific instructions, see Installation Guide.
Create Your First Cluster¶
Basic cluster:
k3d-local create
This creates a cluster with 1 server node, 2 agent nodes, and a ready-to-use kubeconfig.
Full-featured cluster:
k3d-local create --with-traefik --with-apps
This includes:
- k3d cluster
- Traefik v3 ingress controller
- Sample applications
- Pre-configured DNS (sslip.io)
Access Services¶
Once creation completes, access services at:
| Service | URL |
|---|---|
| Traefik Dashboard | http://dashboard.127.0.0.1.sslip.io/dashboard/ |
| Sample App | http://app.127.0.0.1.sslip.io |
Info
k3d-local defaults to port 80 (HTTP) and 443 (HTTPS), so no port suffix is needed in URLs.
Common Operations¶
Deploy production-ready services using the k3d-local examples:
git clone https://github.com/gautampachnanda101/homebrew-tap.git
cd homebrew-tap/examples/argocd
./install.sh
Available examples include:
- ArgoCD – GitOps continuous deployment
- Vault – Secrets management
- Harbor – Container registry
- Authentik / Keycloak – Identity management
- GitLab Runner – CI/CD executor
- Backstage – Developer portal
- And 6 more (External Secrets, RabbitMQ, SpiceDB, OpenFGA, Kyverno)
Check cluster status:
k3d-local status
Delete cluster:
k3d-local delete
Promptx: Encrypted Memory for AI Workflows¶
Get Promptx up and running in 5 minutes.
Install:
brew tap gautampachnanda101/tap
brew install promptx
A Git repository and internet connection are recommended for first-time setup.
Initialize Promptx¶
promptx setup
This creates:
- Encrypted vault for memory storage
- Passkey for encryption
- MCP registrations for IDE integrations
Capture Memory¶
Start capturing interactions:
promptx memory-watch --repo . --interval 5 --force-store
This watches for:
- Git commits
- Code changes
- IDE interactions
In another terminal, work normally — everything is captured and encrypted locally.
Query Memory¶
# Search your history
promptx search "function debugging" --repo . --limit 5
# Ask natural language questions
promptx ask "what changed today?" --repo . --limit 6
# Get evidence-based answers
promptx executor "how do we handle errors?" --repo . --limit 8
VS Code Extension¶
- Install the extension:
code --install-extension $(brew --prefix)/share/promptx/promptx-vscode-*.vsix
- In Copilot Chat, use:
@promptx What changed in the auth module?
@promptx /timeline
Verify Promptx¶
promptx doctor
Shows vault status, memory backend health, MCP registrations, and configuration.
Vaultx: Encrypted Secrets CLI¶
Get vaultx running in 2 minutes.
Install:
brew tap gautampachnanda101/tap
brew install vaultx
Initialize Vaultx¶
vaultx init --biometric # create vault + enable Touch ID (macOS)
vaultx unlock # unlock for this session
Store and Use Secrets¶
vaultx set myapp/db_password "s3cr3t" # store a secret
vaultx get myapp/db_password # retrieve it
vaultx run -- go run ./cmd/server # inject into process
Vaultx Web UI¶
vaultx serve
open http://127.0.0.1:7474/
The dashboard has two tabs — Secrets (manage vault entries) and Audit Log (security events). Touch ID unlocks access on macOS.
Verify Vaultx¶
vaultx version
vaultx doctor