# Orrery

> A spatial Kubernetes cluster visualizer for Apple Vision Pro (iOS later).
> Fly through your cluster as a galaxy; drill from cluster down to pod.
> One-time purchase, fully client-side.

Website: https://kubeorrery.com
Tagline: Orrery for Kubernetes
Positioning: See your cluster as a galaxy.

## What it is

Orrery renders a live Kubernetes cluster as a 3D galaxy on Apple Vision Pro.
The cluster -> namespace -> workload -> pod hierarchy maps to cosmic zoom
levels. Each body (pod, workload, namespace) is a luminous orb sized by pod
count and colored by health state. Relationships are drawn as real Kubernetes
edges: ownership (ownerReferences), scheduling (nodeName), and service backing
(EndpointSlice). Nothing is inferred or mocked. Every visual element traces to
a real API fact.

## Two altitudes

1. Glance: a small fixed-volume diorama sits in your space for ambient
   awareness. You see deploys, pods scaling in and out, and health at a glance,
   with no interaction required.
2. Open up: expand into a full operator console (NOC) for logs, metrics, an
   interactive exec shell, and deliberate operator actions.

## Features

- 3D galaxy view with drill-down from cluster to pod
- Incident blast radius visualization (node failure cascade in real 3D)
- Live logs, container/pod/node metrics, and events
- Interactive pod exec shell (kubectl exec) over WebSocket
- Operator actions: scale deployment, rollout restart, delete pod,
  cordon/uncordon node. All confirmed and deliberate.
- Multi-cluster: import kubeconfig, switch contexts live, ambient diorama shelf
- YAML manifest viewer with secret masking

## Platforms

- Apple Vision Pro (visionOS), primary
- iOS: connectivity and console shared, 3D view to follow

## Privacy & architecture

- Fully client-side. No backend services, no accounts, no telemetry.
- Credentials are stored in the Apple Keychain and talk directly to your
  cluster's API server. Nothing leaves your device.

## Pricing

- One-time purchase, approximately USD $20. Universal across visionOS and iOS.
- No subscription.

## Audience

Kubernetes operators and homelab builders.