Shell Functions¶

Functions are organized by domain across four files in ~/.config/zsh/functions/.

General (`general.zsh`)¶

`cm` — Chezmoi Shortcut¶

cm          # Navigate to chezmoi source directory
cm apply    # Forwards to: chezmoi apply
cm diff     # Forwards to: chezmoi diff

`af` — AWS Profile Switcher¶

Interactive AWS profile selector with SSO login:

af

Lists all AWS profiles via fzf
Exports AWS_PROFILE
Attempts aws sts get-caller-identity
If session expired, triggers aws sso login
Displays account and user info on success

`gh-browse` — GitHub Repo Browser¶

gh-browse myorg    # Browse repos in GitHub org interactively

Uses gh CLI and fzf to select and open repos.

`cloner` — Clone All Org Repos¶

cloner <github_token> <org_name> [page]

Clones all repositories from a GitHub organization.

`git_mirror_to_org` — Mirror Repos Between Orgs¶

git_mirror_to_org source_org repo_name target_org [visibility]

Mirrors a repository from one GitHub org to another.

Keychain secrets

Secrets live in the macOS login keychain and are managed with the keychain-secret script, not a shell function.

Kubernetes (`kubectl.zsh`)¶

`kdebug` — Debug Pod¶

Launch an ephemeral debug pod:

kdebug                           # busybox in default namespace
kdebug -n kube-system            # busybox in kube-system
kdebug -i nicolaka/netshoot      # custom image
kdebug -- curl http://my-svc     # run a command

`kadmin` — Admin Pod¶

Launch a netshoot pod for network debugging:

kadmin                           # netshoot in default namespace
kadmin -n kube-system            # in specific namespace
kadmin -- dig kubernetes.default # run DNS lookup

`kclean` — Delete Pods by Status¶

kclean              # Delete Succeeded pods
kclean Failed       # Delete Failed pods

`kpodbynode` — Pods on a Node¶

kpodbynode ip-10-0-1-123.ec2.internal

`kpodbylabel` — Pods by Label¶

kpodbylabel app=nginx

`kremovefinalizers` — Remove Finalizers¶

kremovefinalizers namespace my-stuck-namespace

Removes all finalizers from a stuck resource to allow deletion.

`kdelete_namespaces_with_prefix` — Bulk Namespace Delete¶

kdelete_namespaces_with_prefix dev-

Finds and deletes all namespaces matching a prefix (with confirmation).

`kdelete_empty_namespaces` — Clean Empty Namespaces¶

kdelete_empty_namespaces                  # Interactive confirmation
kdelete_empty_namespaces --yes            # Skip confirmation
kdelete_empty_namespaces --prefix test-   # Only matching prefix

`inline_kubectl_editor` — Inline Resource Editor¶

inline_kubectl_editor create    # Create resource from inline YAML
inline_kubectl_editor apply     # Apply inline YAML

Opens an inline editor for quick Kubernetes manifest editing.

Terraform (`terraform.zsh`)¶

Helper functions assume this directory structure:

stack/
  environments/
    dev.s3.tfbackend
    dev.tfvars
    prod.s3.tfbackend
    prod.tfvars

`tf_init` — Initialize with Backend¶

tf_init mystack dev
# Runs: terraform init -reconfigure -backend-config=environments/dev.s3.tfbackend

`tf_plan` — Plan with Variables¶

tf_plan mystack dev
# Runs: terraform plan -var-file environments/dev.tfvars

`tf_apply` — Apply with Variables¶

tf_apply mystack dev
# Runs: terraform apply -var-file environments/dev.tfvars

`tf_destroy` — Destroy with Variables¶

tf_destroy mystack dev

`clean_terraform` — Clean Up¶

clean_terraform
# Removes .terraform.lock.hcl and .terraform/ directories

Talos (`talos.zsh`)¶

Functions for managing Talos Linux clusters.

`tx` — Switch Context¶

tx               # List available contexts
tx my-cluster    # Switch to context

`txf` — Interactive Context Switcher¶

txf    # fzf-powered context selection

`tdash` — Dashboard¶

tdash              # Dashboard for current node
tdash 10.0.1.5     # Dashboard for specific node

`tdmesg` — Kernel Messages¶

tdmesg 10.0.1.5              # Full dmesg
tdmesg 10.0.1.5 "error"     # Grep for errors

`tuptime` — Node Uptime¶

tuptime                      # All nodes
tuptime "10.0.1.5 10.0.1.6" # Specific nodes

Shows uptime in human-readable format (days, hours, minutes).

`tlogs` — Node Logs¶

tlogs 10.0.1.5              # kubelet logs (default)
tlogs 10.0.1.5 etcd         # etcd logs

`treboot` — Reboot Node¶

treboot 10.0.1.5    # Prompts for confirmation before rebooting

Shell Functions¶

General (general.zsh)¶

cm — Chezmoi Shortcut¶

af — AWS Profile Switcher¶

gh-browse — GitHub Repo Browser¶

cloner — Clone All Org Repos¶

git_mirror_to_org — Mirror Repos Between Orgs¶

Kubernetes (kubectl.zsh)¶

kdebug — Debug Pod¶

kadmin — Admin Pod¶

kclean — Delete Pods by Status¶

kpodbynode — Pods on a Node¶

kpodbylabel — Pods by Label¶

kremovefinalizers — Remove Finalizers¶

kdelete_namespaces_with_prefix — Bulk Namespace Delete¶

kdelete_empty_namespaces — Clean Empty Namespaces¶

inline_kubectl_editor — Inline Resource Editor¶

Terraform (terraform.zsh)¶

tf_init — Initialize with Backend¶

tf_plan — Plan with Variables¶

tf_apply — Apply with Variables¶

tf_destroy — Destroy with Variables¶

clean_terraform — Clean Up¶

Talos (talos.zsh)¶

tx — Switch Context¶

txf — Interactive Context Switcher¶

tdash — Dashboard¶

tdmesg — Kernel Messages¶

tuptime — Node Uptime¶

tlogs — Node Logs¶

treboot — Reboot Node¶