teleskopio: lightweight Kubernetes web client with AI agent integration
teleskopio by Teleskopio is an open-source, lightweight Kubernetes web client designed to bridge DevOps workflows and AI assistance. It exposes cluster state and management actions through a compact web UI and an embedded Model Context Protocol server so AI coding assistants can query and act on resources. Key elements include live resource monitoring, an integrated code editor, and manifest editing. The tool targets DevOps engineers, SREs, and developers who want a dependency-free, locally runnable cluster client.
What tasks can you actually use it for?
The app focuses on direct cluster operations: inspect Pod logs and event history, scale Deployments and ReplicaSets, and run multi-select management actions such as deleting, draining, and cordoning objects. It supplies live updates through Kubernetes watchers and an integrated Monaco Editor for creating or editing manifests with syntax highlighting. These capabilities are tuned toward ad-hoc troubleshooting, quick rollouts, and manual correction of resource state inside a compact web interface.
Does it require extra local tooling or platform setup?
The client requires no external CLI tooling because it uses a native Go-client implementation to talk to the Kubernetes API server, so kubectl and Helm are not necessary. It supports multiple kubeconfig files through the $KUBECONFIG environment variable and runs across platforms as a Linux binary, a macOS Homebrew cask, or inside Docker. That makes installation options flexible for both developer workstations and containerized deployments.
Is it suitable for secure or air-gapped production environments?
The tool is explicitly air-gap ready, it makes no external requests and bundles required components to run locally or within a private network. Access control is provided via JWT token authorization with role separation for administrators and viewers. The project is open-source and maintained on GitHub, which allows teams to audit the code and adapt the client for controlled deployment environments.
A practical choice for AI-aware, audit-focused cluster workflows
teleskopio suits engineers who need a compact, auditable client that fits local or private deployments and supports integration with MCP-compatible hosts such as Claude Desktop, Cursor, and VS Code. Expect to treat any agent-driven suggestions as prompts rather than final answers, and validate generated changes before applying them to production clusters to avoid unintended actions.
