https://github.com/codingprotocols/podscape
A modern Kubernetes desktop client built with Electron. Manage clusters, workloads, networking, Helm, and more — all from your desktop.
https://github.com/codingprotocols/podscape
cloud-native containers desktop devops electron helm k8s kubernetes kubernetes-dashboard kubernetes-management kubernetes-ui react typescript
Last synced: 7 days ago
JSON representation
A modern Kubernetes desktop client built with Electron. Manage clusters, workloads, networking, Helm, and more — all from your desktop.
- Host: GitHub
- URL: https://github.com/codingprotocols/podscape
- Owner: codingprotocols
- License: mit
- Created: 2026-02-25T12:51:18.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T15:34:11.000Z (11 days ago)
- Last Synced: 2026-04-01T15:34:44.638Z (11 days ago)
- Topics: cloud-native, containers, desktop, devops, electron, helm, k8s, kubernetes, kubernetes-dashboard, kubernetes-management, kubernetes-ui, react, typescript
- Language: TypeScript
- Homepage: https://codingprotocols.com/podscape
- Size: 7.9 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Podscape
A desktop Kubernetes management app built on Electron + React + TypeScript + Go.
Manage clusters, stream logs, exec into containers, inspect RBAC, visualise network topology, and more — all from a single native app.
**[Download](https://github.com/codingprotocols/podscape/releases/latest)** · **[Docs](https://codingprotocols.github.io/podscape/)** · **[Issues](https://github.com/codingprotocols/podscape/issues)**
---
---
## Screenshots
| **Debug Launcher** | **Restart Analyzer** |
| :---: | :---: |
|  |  |
| *One-click ephemeral debug tools* | *Automated CrashLoop diagnosis* |
| **Network Map** | **Onboarding** |
| :---: | :---: |
|  |  |
| *Visual traffic flow intelligence* | *Sleek glassmorphism UX* |
| **Terminal** | **Unified Log Streaming** |
| :---: | :---: |
|  |  |
| *Built-in PTY terminal* | *Real-time multi-pod log streaming* |
---
## Features
- **Multi-cluster support** — switch contexts and namespaces instantly; RBAC-aware startup skips resources the current user cannot access
- **Full resource coverage** — pods, deployments, statefulsets, daemonsets, jobs, cronjobs, HPAs, PDBs, services, ingresses, network policies, configmaps, secrets, RBAC, storage, and more
- **Log streaming** — real-time log tailing with multi-container support and search
- **Exec into containers** — full PTY terminal sessions directly in the app
- **Port forwarding** — one-click port-forward with live status, auto port detection, and clickable local URLs
- **Helm management** — list releases, inspect values, view history, rollback
- **Network topology** — force-directed graph of pod-to-service relationships
- **Security scan** — per-pod security posture analysis (privileged containers, missing resource limits, host namespace access)
- **TLS dashboard** — cluster-wide certificate inventory with expiry tracking
- **GitOps panel** — Argo CD / Flux resource overview
- **Service mesh support** — Istio, Traefik v2/v3, NGINX Inc, NGINX Community — auto-detected per cluster
- **Events & metrics** — filterable event list and pod/node metrics (requires metrics-server)
- **Built-in terminal** — tabbed PTY terminal with kubectl pre-configured
- **MCP server** — expose your cluster as tools for AI assistants via `podscape-mcp`
---
## Installation
Download the latest release for your platform from [GitHub Releases](https://github.com/codingprotocols/podscape/releases/latest):
| Platform | Format |
|----------|--------|
| macOS (Apple Silicon + Intel) | Universal DMG |
| Windows | NSIS installer |
| Linux | AppImage, `.deb` |
**macOS note:** The app is signed and notarized. If macOS blocks it on first launch, right-click → Open.
---
## Building from source
**Prerequisites:** Node.js 20+, Go 1.22+
```bash
# Clone and install dependencies
git clone https://github.com/codingprotocols/podscape.git
cd podscape-electron
npm install
# Build the Go sidecar (required before first run)
cd go-core && go build ./cmd/podscape-core/ && cd ..
# Start in dev mode (hot reload)
npm run dev
```
### Other commands
```bash
npm run build # Build all processes
npm run test # Run frontend tests (vitest)
npm run test:watch # Watch mode
cd go-core
go test ./... # Run Go tests
go build ./cmd/podscape-mcp/ # Build the MCP server binary
```
---
## MCP Server
`podscape-mcp` is a standalone binary that exposes your Kubernetes cluster as tools for AI assistants (Claude, Cursor, Copilot, etc.). It ships as a pre-built binary for macOS, Windows, and Linux alongside the app on every **[GitHub Release](https://github.com/codingprotocols/podscape/releases/latest)**.
```bash
# Register with Claude Code (using a pre-built binary)
claude mcp add --transport stdio podscape -- /path/to/podscape-mcp-darwin-arm64
# Or build from source
cd go-core && go build ./cmd/podscape-mcp/
claude mcp add --transport stdio podscape -- ./go-core/podscape-mcp
```
See [go-core/cmd/podscape-mcp/README.md](go-core/cmd/podscape-mcp/README.md) for full setup and tool reference.
---
## Architecture
Podscape is a three-process Electron app with a Go sidecar:
```
Renderer (React/TS)
├─ HTTP → Go Sidecar (127.0.0.1:5050) — all k8s + Helm operations
└─ IPC → Main Process (Node.js) — terminal, file dialogs, port-forward, log streaming
```
| Layer | Stack |
|-------|-------|
| Renderer | React 18, TypeScript, Tailwind CSS, Zustand, xterm.js, Monaco Editor, Recharts |
| Main process | Electron, node-pty |
| Go sidecar | `podscape-core` — HTTP server, shared informer cache, RBAC probe |
| MCP server | `podscape-mcp` — standalone MCP server |
---
## Project structure
```
podscape-electron/
├── src/
│ ├── main/ # Electron main process (sidecar, IPC handlers, terminal)
│ ├── preload/ # Context bridge — exposes window.kubectl, window.helm, etc.
│ └── renderer/ # React app (components, store, routing)
├── go-core/
│ ├── cmd/
│ │ ├── podscape-core/ # HTTP sidecar binary
│ │ └── podscape-mcp/ # MCP server binary
│ └── internal/
│ ├── client/ # Shared k8s client initialisation
│ ├── handlers/ # HTTP route handlers
│ ├── informers/ # Shared informer cache
│ ├── ops/ # Write operations (scale, delete, apply, rollout)
│ ├── logs/ # Log streaming
│ ├── helm/ # Helm SDK wrapper
│ ├── rbac/ # RBAC probe
│ ├── store/ # Global sidecar state
│ └── portforward/ # Port-forward manager
├── resources/ # Icons, splash screen
├── scripts/ # Build helpers (notarize, icon generation)
└── CHANGELOG.md
```
---
## Distribution
Releases are triggered by pushing a `v*` tag. GitHub Actions builds for macOS (arm64 + x64), Windows, and Linux in parallel and publishes to GitHub Releases.
```bash
git tag v2.3.0 && git push origin v2.3.0
```
### macOS signing + notarization
Set these repository secrets before releasing:
| Secret | Description |
|--------|-------------|
| `CSC_LINK` | Base64-encoded `.p12` Developer ID certificate |
| `CSC_KEY_PASSWORD` | `.p12` password |
| `APPLE_ID` | Apple ID email |
| `APPLE_APP_SPECIFIC_PASSWORD` | App-specific password from appleid.apple.com |
| `APPLE_TEAM_ID` | 10-character Apple Team ID |
| `GH_TOKEN` | GitHub PAT with `repo` scope |
---
## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request.
---
## License
MIT License — see [LICENSE](LICENSE) for details.
© 2026 Coding Protocols Private Limited