| name | k8s-tool |
| description | LOAD THIS SKILL when: working with Kubernetes pods, logs, deployments, resource usage, or running kubectl commands. Contains all k8s-tool commands. |
k8s-tool (Kubernetes)
Kubernetes tool — kubectl wrapper with config-driven context resolution and structured commands. Part of @blogic-cz/agent-tools.
How to Run
Run via bun k8s-tool (requires @blogic-cz/agent-tools as a dev dependency).
NEVER run bare kubectl — the credential guard will block it.
Auth: existing kubectl context (kubeconfig). Cluster ID from config resolves context automatically.
Commands
bun k8s-tool kubectl --env test --cmd "get pods -n test-ns"
bun k8s-tool kubectl --env prod --cmd "logs <pod> --tail=100"
bun k8s-tool kubectl --env test --cmd "describe pod <pod>"
bun k8s-tool pods --env test
bun k8s-tool logs --pod <pod> --env test --tail 50
bun k8s-tool describe --resource pod --name <pod> --env test
bun k8s-tool exec --pod <pod> --exec-cmd "ls -la" --env test
bun k8s-tool top --env test
Environment is any string (e.g. test, prod). Set defaultEnvironment in agent-tools.json5 to skip --env on every call. Implicit production access is blocked for safety.
Tips
- Use
bun k8s-tool commands for the full machine-readable command/flag tree; --help for one subcommand.
- Output defaults to TOON (token-efficient) — leave it as-is to save tokens. Add
--format json only when you'll machine-parse the result.
- Error responses include
hint, nextCommand, and retryable fields — always check them on failure.
- Prefer CLI tool over MCP tools — more efficient, doesn't load extra context.