GOD'S EYE VIEW

// Guide

How to use God's Eye View

God's Eye View runs on your computer and opens in your browser. It's free and MIT licensed, and it starts without an account or API keys: Esri satellite imagery and keyless terrain load out of the box, along with flights, military traffic, satellites, earthquakes, public cameras, radio and launches.

1. Install it

One click (Windows, macOS, Linux). Install or update Pinokio to 8.2 or later, open God's Eye View on Pinokio, then click Install and Start. Pinokio installs the locked dependencies, finds a free port and opens the app in your browser.

From a terminal. Use Node.js 24 (24.14.0 or later) or 26:

$ git clone https://github.com/bilawalsidhu/gods-eye-view.git
$ cd gods-eye-view
$ npm ci
$ npm run doctor
$ npm run dev

Then open http://localhost:4173.

With Docker. No Node install needed: clone the repository and run docker compose up, then open http://localhost:4173. Your keys, cached map data and logs stay in the folder you cloned.

Already installed? Update to the latest version. Older versions query public OpenStreetMap Overpass servers that now refuse them, so Traffic, Mapped Installations and ALPR stay empty until you update. More detail is on the download page.

2. Your first five minutes

3. Keyboard shortcuts

4. Add keys for more (optional)

Click the POWER UP chip in the bottom-right corner. Provider Settings lists every supported key, what it switches on and where to get it; paste, hit SAVE KEYS, and the app restarts with the new capability. If a compact layout hides the chip, add ?setup=1 to the address.

Most layers cost nothing and need no signup. Keys stay on your machine, in a local owner-only file excluded from Git. Provider terms and quotas apply.

5. Talk to it

Choose OpenAI or Gemini under AI Provider in Settings. Click GEV MIC, grant the microphone and talk, for example: "Take me to LAX and select the nearest airborne aircraft." CHAT, next to the mic, opens a typed chat that uses the same map actions. API-key voice sessions show a live spend readout with a $2 warning and a $5 hard cap.

6. Connect Claude or Codex (MCP)

The MCP server runs locally. With the app running at http://localhost:4173, add the server from your checkout:

$ claude mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173
$ codex mcp add gods-eye-view -- node /abs/path/gods-eye-view/server/mcp/stdio.js --api-base http://localhost:4173

Codex and ChatGPT desktop and Claude Desktop take the same server in their MCP settings. The MCP setup guide has every client.

7. Share a view

The share button makes a short /share/ link. The camera, style, layers and even one tracked target travel in the link, so it opens the same way on any copy of the app.

8. Keep it on your machine

The server binds to localhost, and Provider Settings answers only requests from your machine. Sharing on your network is an explicit opt-in. SECURITY.md has the details.

Get it on GitHub