How maniacbeast20/kubenexus-v2 works
KubeNexus is a local natural-language Kubernetes CLI. The main workflow accepts a user request, intercepts sensitive input, parses it with a local Ollama model, validates and applies guardrails, then routes the intent to a Kubernetes operation. Deploy, workload management, observation, cleanup, and rollback are distinct execution stages; dry-run and destructive confirmation are safety branches. The audit log supports history and rollback. Relationships are based on README workflow statements and the shown source/index references; unsampled dispatch details are not inferred beyond those links.
Main entry points: main.py CLI workflow · rollback.py Rollback pillar · action_log.py Action log · parser.py Intent parser
Components 18
Request handling
- CLI workflow
kubenxs/main.py - Intent parser
kubenxs/parser.py
Safety and policy
- Secret interceptor
kubenxs/interceptor.py - Intent validator
kubenxs/validator.py - Policy guardrails
kubenxs/guardrails.py - Policy config
kubenxs/config.py - Dry-run preview
kubenxs/dry_run.py - Destructive confirmation
kubenxs/confirm.py
Kubernetes operations
- Deploy pillar
kubenxs/pillars/deploy.py - Workload management
kubenxs/pillars/manage.py - Cluster observation
kubenxs/pillars/observe.py - Cleanup pillar
kubenxs/pillars/cleanup.py - Rollback pillar
kubenxs/pillars/rollback.py
Audit and history
- Action log
kubenxs/action_log.py - History viewer
kubenxs/main.py
Other components
- CLI user
- Local Ollama
- kubectl
Connections 23
- CLI user → CLI workflow: submits request
README.md - CLI workflow → Secret interceptor: scans input
README.md - CLI workflow → Intent parser: sends clean prompt
README.md - Intent parser → Local Ollama: requests parsing
README.md - CLI workflow → Intent validator: validates intent
README.md - CLI workflow → Policy guardrails: checks policy
kubenxs/main.py - Policy guardrails → Policy config: loads policy
kubenxs/guardrails.py - CLI workflow → Dry-run preview: previews intent
kubenxs/main.py - CLI workflow → Destructive confirmation: requests confirmation
kubenxs/main.py - CLI workflow → Deploy pillar: routes deploy
README.md - CLI workflow → Workload management: routes mutations
README.md - CLI workflow → Cluster observation: routes inspection
README.md - CLI workflow → Cleanup pillar: routes cleanup
README.md - CLI workflow → Rollback pillar: routes rollback
README.md - Deploy pillar → kubectl: applies manifests
kubenxs/pillars/deploy.py - Workload management → kubectl: runs mutations
kubenxs/pillars/manage.py - Cluster observation → kubectl: reads cluster
kubenxs/pillars/observe.py - Cleanup pillar → kubectl: deletes resources
kubenxs/pillars/cleanup.py - Rollback pillar → kubectl: restores workload
kubenxs/pillars/rollback.py - CLI workflow → Action log: records actions
README.md - Rollback pillar → Action log: looks up snapshots
kubenxs/pillars/rollback.py - CLI workflow → History viewer: serves history
README.md - History viewer → Action log: filters entries
kubenxs/main.py