Omni Go

Your Omni Code server in your pocket. Omni Go is the Flutter mobile companion that gives you chat, files, terminal, and device tools — all through your phone, connected to your desktop.

[VIEW ON GITHUB][REQUIRES OMNI CODE →]

// info

PlatformiOS + Android

FrameworkFlutter (Dart 3)

StateRiverpod

AuthHMAC-signed

LicenseMIT

// connect

Connect in 3 steps.

Enable the remote server

In Omni Code, open Settings → Remote Server, set an API key, and click Start. An optional ngrok tunnel lets you connect over the internet.

Open Omni Go and scan

Tap the QR icon on the connect screen in Omni Go. Point your camera at the QR code shown in Omni Code's remote server settings.

You're connected

Omni Go authenticates with HMAC-signed requests. Your chat history, workspaces, and terminal sessions are immediately available.

// features

Everything on your phone.

// tab

Chat

Full conversational access to the Omni Code agent. Send messages, receive streamed responses, and review agent tool calls in real time.

// tab

Files

Browse, read, and write files on your desktop machine. The file tree mirrors your Omni Code workspace.

// tab

Terminal

Persistent terminal sessions streamed to your phone. Run commands, tail logs, or manage processes from anywhere.

// tab

Browser

Embedded WebView for browsing content proxied through your desktop — useful for accessing local dev servers.

// tab

Devices

ADB and iOS device management tools exposed by Omni Code's remote server. Run commands on connected devices.

// tab

Settings

Configure server URL, API key, workspace selection, and app preferences.

// architecture

How it connects.

network diagram

  ┌─────────────────────────────┐     ┌──────────────────────────┐
  │        OMNI CODE            │     │        OMNI GO           │
  │  (Electron / Node.js)       │     │  (Flutter / Dart)        │
  │                             │     │                          │
  │  ┌─────────────────────┐    │     │  ┌────────────────────┐  │
  │  │  AI Agent Engine    │    │     │  │  Chat Screen       │  │
  │  │  (TypeScript)       │    │     │  │  Files Screen      │  │
  │  └──────────┬──────────┘    │     │  │  Terminal Screen   │  │
  │             │               │     │  │  Devices Screen    │  │
  │  ┌──────────▼──────────┐    │     │  └────────┬───────────┘  │
  │  │  Remote API Server  │◄───┼─────┼───────────┘              │
  │  │  (Express + SSE)    │    │     │  REST + Server-Sent       │
  │  │  localhost:3000     │    │     │  Events (HMAC auth)       │
  │  └─────────────────────┘    │     └──────────────────────────┘
  └─────────────────────────────┘
              │
              │ optional
  ┌───────────▼──────────┐
  │  ngrok tunnel        │
  │  (internet access)   │
  └──────────────────────┘

// build from source

Build Omni Go yourself.

# Clone
$ git clone https://github.com/GraysonBannister/omni-code-go

# Install dependencies
$ cd omni-code-go && flutter pub get

# Run on connected device / emulator
$ flutter run

Requires Flutter 3.x and Dart 3. Connect to a running Omni Code instance with the remote server enabled.