Toolbox CLI

The primary function is to help manage and connect to PostHog toolbox pods in a Kubernetes environment.

Installation

Python 3.x
kubectl installed and configured
your current settings and k8s context let you access the cluster that you want your toolbox to be claimed in

Run the script using Python:

python toolbox.py [flags]

Or directly (Unix-based systems):

./toolbox.py [flags]

The toolbox CLI:

Authenticates your AWS identity
Finds an available PostHog toolbox pod or connects to one you've already claimed
Claims the pod for a specified duration (default 12 hours)
Provides an interactive shell session to the pod
Offers to delete the pod when you exit the shell

Flag	Description	Default
`--claim-duration HOURS`	Number of hours to claim the pod for	12
`--update-claim`	Update the termination time of your existing pod	False

python toolbox.py

python toolbox.py --claim-duration 4

python toolbox.py --update-claim --claim-duration 24

If no pods are available, the script will wait up to 5 minutes for a pod to become available
When you exit the pod shell, you'll be prompted whether to delete the pod
If something doesn't work as expected, reach out to #team-infrastructure for assistance