# Hypernova

> A control room for Claude Code and Codex on Android, Mac and Linux. An Android app, a Mac menu bar app and a Linux service let you watch, approve and steer the coding agents running on your own Mac or Linux server, from your phone and Even Realities G2 glasses. Free and open source (Apache-2.0), self-hosted, with no Hypernova server in between.

- Current version: 0.2.0 (2026-10-22), alpha.
- Hosts: a Mac with Apple silicon on macOS 14 or later (the menu bar app), or Linux (Ubuntu or Debian, x86_64 or arm64; a VPS, a home server or Docker; the `hypernova` command).
- Phone: Android 10 or later. Glasses: Even Realities G2 (Hypernova Lens, through the phone app).
- Agents: Claude Code, OpenAI's Codex (0.163.0 or later), or both.
- Connection: directly on the same Wi-Fi (mutual TLS), or over your own Tailscale network (built in on the Mac, Linux and the phone). Only a small name service for pairing and private names is hosted; it never sees sessions.
- Author: Nikita Prudnikov (https://nikbraun.tech). Source: https://github.com/prudnik-web/Hypernova. Not affiliated with Anthropic, OpenAI or Even Realities.

## Install

- [Install Hypernova](https://hypernova.nikbraun.tech/install/): downloads for Mac, Linux and Android, and the setup step by step
- [Hypernova on Linux](https://hypernova.nikbraun.tech/install/linux/): a VPS, a home server or Docker
- [Latest release on GitHub](https://github.com/prudnik-web/Hypernova/releases/latest): Hypernova.dmg, Hypernova.apk, Hypernova-linux.tar.gz, Hypernova-Lens.ehpk, SHA256SUMS.txt

## Guides

- [Claude Code on your phone](https://hypernova.nikbraun.tech/guides/claude-code-on-your-phone/): Watch, answer and start Claude Code sessions on your Mac or Linux server from an Android phone. A free, open source, self-hosted remote control.
- [Approve Claude Code permissions from your phone](https://hypernova.nikbraun.tech/guides/approve-claude-code-permissions-from-android/): Answer Claude Code's permission prompts from an Android phone: Allow, Deny or Always, from the app or the notification, with a 10-minute auto-deny.
- [Codex on your phone](https://hypernova.nikbraun.tech/guides/codex-on-your-phone/): Start, follow and approve OpenAI Codex sessions on your Mac or Linux server from an Android phone, next to Claude Code or on its own. Free and open source.
- [Use Claude Code and Codex together](https://hypernova.nikbraun.tech/guides/claude-code-and-codex-together/): Run Claude Code and OpenAI's Codex side by side from your phone: each with its own sessions and usage, and switch a conversation from one agent to the other.
- [A Claude Code usage limit tracker for your phone and menu bar](https://hypernova.nikbraun.tech/guides/claude-code-usage-limits/): See Claude Code's 5-hour and weekly limits as Claude Code reports them, where your pace is heading and when each resets, on your phone and Mac.
- [Remote access to Claude Code, from anywhere](https://hypernova.nikbraun.tech/guides/claude-code-remote-access-tailscale/): Reach Claude Code on your Mac or Linux server from anywhere: directly on your Wi‑Fi, or over your own Tailscale network, nothing opened to the internet.
- [Claude Code on a VPS or home server, reachable from your phone](https://hypernova.nikbraun.tech/guides/claude-code-on-a-vps/): Why an always-on Linux host for Claude Code helps, and how a VPS, a home server or Docker pairs with your Android phone through self-hosted Hypernova.
- [Run Claude Code on a Linux server and control it from your phone](https://hypernova.nikbraun.tech/guides/run-claude-code-on-a-linux-server/): Install Hypernova on Ubuntu or Debian, or in Docker, to run Claude Code there and pair your Android phone: commands, the systemd service and fixes.
- [Claude Code on Even Realities G2 glasses](https://hypernova.nikbraun.tech/guides/claude-code-on-even-g2-glasses/): Hypernova Lens puts your Claude Code sessions on Even Realities G2 glasses: a glance at what runs, approvals by tap or voice, replies read aloud.

## Reference

- [FAQ](https://hypernova.nikbraun.tech/faq/): 18 questions and answers
- [Source code](https://github.com/prudnik-web/Hypernova)
- [Protocol](https://github.com/prudnik-web/Hypernova/blob/main/docs/PROTOCOL.md): the API between the apps and the service
- [Security model](https://github.com/prudnik-web/Hypernova/blob/main/docs/SECURITY-MODEL.md): what runs and is stored where, and who sees what
- [Decisions](https://github.com/prudnik-web/Hypernova/blob/main/docs/DECISIONS.md): what was agreed and why

## Optional

- [Full text](https://hypernova.nikbraun.tech/llms-full.txt): the install guides, every guide and the FAQ in one file