The Four Families of the 28 Voice Tools in God's Eye View: Complete Documentation

God's Eye View organizes its 28 voice‑tool commands into four distinct families—Direct it, Annotate it, Interrogate it, and Operate it—that control camera movement, map annotation, data queries, and application‑wide console commands respectively.

God's Eye View (bilawalsidhu/gods-eye-view) is an open‑source geospatial visualization platform that integrates OpenAI's Realtime API for hands‑free operation. The system ships with 28 voice‑tool commands grouped into four families (also referred to as "jobs" in the documentation), allowing users to control the camera, annotate maps, query live data layers, and manipulate the application interface through natural speech. According to the README.md documentation under the "Talk to It" section—specifically lines 36‑55—these families represent the four functional categories that organize all voice interactions【/tmp/instagit_doi2bxvp/README.md#L36-L55】.

The Four Families of Voice Tools

The 28 voice tools are divided into four functional families based on the type of action they perform. Each family targets a specific interaction model, from drone‑style camera control to console‑wide system operations.

Direct it: The Drone‑Operator Camera Verbs

The Direct it family handles all camera movement and navigation commands. These tools interpret instructions to move, orbit, or fly the camera around the globe, effectively treating the viewport as a remotely piloted aircraft.

Common invocations include flying to specific coordinates, initiating orbital movements around points of interest, or adjusting zoom levels for global context. According to the codebase, these commands are processed through the voice session and dispatched to the camera controller in src/voice/gevRealtime.js.

Example usage:

// Move camera to specific location
gevRealtime.session.sendVoiceCommand('Take me to Tokyo');

// Orbital camera movement
gevRealtime.session.sendVoiceCommand('Orbit around this area slowly');

// Zoom control
gevRealtime.session.sendVoiceCommand('Zoom out to a globe view');

Annotate it: The Voice Whiteboard

The Annotate it family transforms voice input into map annotations, functioning as a voice‑driven whiteboard for geographic markup. These tools draw outlines, add labels, and measure distances between features on the live map canvas.

This family enables rapid spatial markup without manual drawing tools, allowing operators to outline regions, label landmarks, or calculate geospatial relationships through natural language.

Example usage:

// Geographic outlining
gevRealtime.session.sendVoiceCommand('Outline the state of Texas');

// Landmark annotation
gevRealtime.session.sendVoiceCommand('Annotate the Texas State Capitol and its grounds');

// Distance measurement
gevRealtime.session.sendVoiceCommand('How far is the Eiffel Tower from the Louvre?');

Interrogate it: The Analyst Queries

The Interrogate it family provides data‑driven query capabilities against live information layers including flights, maritime traffic, wildfires, and orbital objects. These tools answer quantitative and situational questions about real‑time data displayed on the map.

Unlike camera control commands, these tools interface with the application's data layers to retrieve counts, trajectories, and temporal information about moving objects and environmental events.

Example usage:

// Flight traffic analysis
gevRealtime.session.sendVoiceCommand('How many flights are over Texas right now?');

// Maritime tracking
gevRealtime.session.sendVoiceCommand('Which ships are headed to Oakland?');

// Orbital mechanics query
gevRealtime.session.sendVoiceCommand('When does the ISS pass over next?');

Operate it: The Console‑Wide Commands

The Operate it family manages application‑level state and configuration, controlling layers, visual styles, audio systems, and operational contexts. These console commands affect the entire interface rather than just the camera or individual data points.

This family includes toggling visualization layers (flights, ships, fires), switching between day/night modes, activating radio streams, and entering specialized view modes like Cockpit view.

Example usage:

// Layer and style modification
gevRealtime.session.sendVoiceCommand('Switch to night vision and turn on the flights layer');

// Audio control
gevRealtime.session.sendVoiceCommand('Play a news radio station near Austin');

// Context switching
gevRealtime.session.sendVoiceCommand('Enter Cockpit');

Implementation Architecture

The voice tool families are implemented across several key files in the repository. The src/voice/gevRealtime.js module handles the voice UI, command parsing, and dispatch logic that routes utterances to the appropriate family handler. This file implements the sendVoiceCommand method used in all code examples, which transmits processed speech to the OpenAI Realtime API and returns structured commands for execution.

Supporting infrastructure resides in src/voice/voiceCost.js, which provides the model registry and cost‑tracking functionality used by active voice sessions. This separation of concerns allows the voice system to track API usage across the four tool families while maintaining clean dispatch logic in the main realtime module.

The documentation explicitly notes "Twenty‑eight tools, four jobs" in the README's "Talk to It" section, mapping each natural language command to one of the four functional families described above【/tmp/instagit_doi2bxvp/README.md#L36-L55】.

Summary

• God's Eye View provides 28 voice‑tool commands organized into four distinct families that cover camera navigation, map annotation, data interrogation, and system operation.
• The Direct it family controls camera movement and positioning using drone‑operator verbs.
• The Annotate it family enables voice‑driven drawing, labeling, and measurement on the map canvas.
• The Interrogate it family queries live data layers for flights, ships, fires, and orbital objects.
• The Operate it family manages application state, toggling layers, styles, audio, and operational contexts.
• Implementation resides primarily in src/voice/gevRealtime.js (command dispatch) and src/voice/voiceCost.js (cost tracking), with documentation in README.md lines 36‑55.

Frequently Asked Questions

How are the 28 voice tools divided into families?

The 28 voice tools are divided into four functional families based on their operational domain: Direct it (camera control), Annotate it (map markup), Interrogate it (data queries), and Operate it (application settings). Each family groups tools that perform similar categories of actions, making the voice interface predictable for users familiar with drone operations, whiteboarding, data analysis, or console administration.

What file handles voice command processing in God's Eye View?

Voice command processing is implemented in src/voice/gevRealtime.js, which contains the voice UI logic, command parsing infrastructure, and the sendVoiceCommand method used to dispatch instructions to the appropriate tool family. This module interfaces with the OpenAI Realtime API to convert speech into actionable commands for the four families.

Can I query live flight data using voice commands?

Yes, live flight data queries fall under the Interrogate it family. You can ask questions such as "How many flights are over Texas right now?" or "Which ships are headed to Oakland?" and the system will query the live aviation and maritime layers currently enabled on the map. These commands are processed as analyst queries against real‑time data feeds.

What is the difference between Direct it and Operate it commands?

Direct it commands control the camera viewport—moving the point of view, orbiting locations, or adjusting zoom levels—while Operate it commands modify the application itself, such as toggling data layers, changing visual styles to night vision, playing radio stations, or switching into specialized modes like Cockpit view. Direct it manipulates where you look; Operate it manipulates what you see and hear.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}