nowake.ai Docs
This documentation site collects public, task-oriented documentation for nowake.ai projects while keeping each project repository as the source of truth.
Projects
Section titled “Projects”kube-insight is an AIOps infrastructure component for retained Kubernetes evidence: sanitized history, facts, edges, observations, an embedded Web UI, and query surfaces for humans and agents.
svc-lb-mux is an operations-first Kubernetes controller that lets multiple application-facing LoadBalancer Services share one provider-managed Layer 4 load balancer, including channel-driven external-dns aggregation.
BetterNAT is a self-hosted, highly available, observable egress gateway for AWS and GCP private workloads, with v0.2 Terraform modules as the recommended install path.
Getting Started
Section titled “Getting Started”Start with the project overview that matches the system you are evaluating:
- Use kube-insight when you need retained Kubernetes state for investigation, automation, or agent workflows.
- Use svc-lb-mux when cloud provider load balancer count, cost, or port management is becoming operationally painful.
- Use BetterNAT when private workloads move enough public internet traffic that managed NAT processing fees, route ownership, failover behavior, and observability deserve an explicit cost and operations tradeoff.
Agent And UI Workflows
Section titled “Agent And UI Workflows”kube-insight now publishes both agent paths:
- Built-in Web UI Agent for running the agent loop inside kube-insight with server-side credentials.
- External Agent Skill for connecting Codex, Claude, or another MCP-capable agent to the evidence service.
- Agent SQL Workflows for schema-first retained-evidence investigations.
Operations
Section titled “Operations”The docs prioritize install paths, validation commands, GitOps guidance, provider limits, troubleshooting flows, and realistic expected output.
Key kube-insight operations pages now include Configuration, Processing Model, Troubleshooting Workflows, Validated Troubleshooting Scenarios, and the Service-Mux History Case Report.
svc-lb-mux operations docs include GitOps, Troubleshooting, and Pressure Testing.
BetterNAT operations docs include Observability, Operations Guide, Rollback, Failure Modes, and Current Limits.
Security
Section titled “Security”Public docs should state trust boundaries, sanitization behavior, permissions, sensitive data handling, and current gaps near the commands or configuration they affect.
kube-insight security docs include current Sanitization And Retention behavior plus roadmap design notes for Kubernetes RBAC Inheritance and Agent SQL RBAC Filtering.
BetterNAT security docs include IAM Policy and Security Hardening for the self-managed gateway model.
Source Model
Section titled “Source Model”Project-specific docs remain canonical in each project repository. The website keeps those repositories as submodules under vendor/, and npm run sync:docs copies only the explicitly listed public docs from docs.sources.json into Starlight content before local dev, CI checks, and production builds.