Skip to main content
hexr status gives you a live view of every agent running in your Kubernetes tenant namespace. It queries the cluster for all Hexr-managed pods and prints a summary table with each agent’s container health count, age, and full SPIFFE ID. You use it to confirm a successful hexr deploy, check on an agent after a restart, or quickly audit what’s running in a given namespace.

​
Usage

hexr status [--namespace <namespace>]

​
Output

$ hexr status

Deployed Agents (tenant-acme-corp):
┌───────────────────────────────┬─────────┬────────────┬──────────┬────────────────────────────────────────────┐
│ Agent                         │ Status  │ Containers │ Age      │ SPIFFE ID                                  │
├───────────────────────────────┼─────────┼────────────┼──────────┼────────────────────────────────────────────┤
│ research-analyst              │ Running │ 4/4        │ 2h       │ spiffe://hexr.cloud/agent/acme/research-…  │
│ content-crew                  │ Running │ 4/4        │ 1d       │ spiffe://hexr.cloud/agent/acme/content-…   │
│ financial-analysis            │ Running │ 4/4        │ 3d       │ spiffe://hexr.cloud/agent/acme/financial-… │
│ browser-research              │ Running │ 3/3        │ 3d       │ spiffe://hexr.cloud/agent/acme/browser-…   │
│ multiprocess-test             │ Running │ 3/3        │ 3d       │ spiffe://hexr.cloud/agent/acme/multi-…     │
└───────────────────────────────┴─────────┴────────────┴──────────┴────────────────────────────────────────────┘

5 agents deployed | 5 running | 0 pending | 0 failed
The Containers column shows running/total. A standard Hexr agent pod runs 4 containers: the agent itself, Envoy sidecar, A2A sidecar, and the PID mapper. Agents without A2A enabled run 3 containers.
hexr status reads from the Kubernetes cluster configured in your current kubectl context. Use --namespace to query a specific tenant namespace if you manage multiple tenants.