hypernova/
Menu
Install
Hypernova 0.2.0Open source · Apache-2.0

A control room for Claude Code and Codex.

Watch, approve and steer the coding agents on your Mac or Linux server from your Android phone, the Mac's menu bar and Even Realities G2 glasses. It runs on your own machine, with no Hypernova server in between.

Install Hypernova Source on GitHub
Android 10+macOS 14+LinuxEven G2

Free and open source. Alpha: used every day, built with Claude Code.

An illustration of the app's Home: the sun is an accretion disk showing 43% of the 5-hour window used, with projects as planets round it (two working, one that needs you) and Codex's smaller star at the edge.

A session: the usage strip, the agent's edits and a build, and a NEEDS YOU card with Deny, Always and Allow
SESSIONS• 1 needs you • 2 working

Let it run. Step in when it needs you.

Coding agents do their best work when you let them run, and they need you at the worst moment: a command to approve, a question to answer, a limit to wait out. Hypernova keeps you in the loop wherever you are: the phone is your window, the glasses your screen and your voice the keyboard.

0STEMSc7 ⏱ 1m

release landing copy

wants to run git push origin main

Needs youOpusask first
HYPERNOVAa3 ⏱ now

cosmos renderer

Edit: android/…/fx/Disk.kt

Working2 agentsSonnetaccept edits
LANDINGe2 ⏱ 4m

pricing page tests

Bash: npm test

WorkingCodexDefault
WHERE IT RUNSMac · Linux · Docker

Your Mac, or a server that never sleeps.

Hypernova's service runs next to your agents, on your own machine. The phone and the glasses pair with any of these the same way.

MACmacOS 14+ · Apple silicon

A Mac, from the menu bar.

The menu bar app installs and runs the service, connects Claude Code and Codex, sets up Tailscale and pairs your phone with a QR code. A planet in the menu bar turns while anything works and shows a dot when something needs you.

Install on a Mac
LINUX SERVERUbuntu · Debian

A VPS or a home server.

The same service as a systemd user service on an always-on machine, run as the hypernova command over SSH. Tailscale is built in, and hypernova pair shows the pairing code right in the terminal.

Install on Linux
DOCKERthe quickest look

A container, to try it.

Build the image from a checkout and run it with a volume for its state. Nothing is published to the network; sign in to Claude once and pair with hypernova pair inside it.

Try it in Docker
ON THE PHONEAndroid 10+

Everything the terminal knows, in your pocket.

The Android app is a native app, not a web page: live sessions, approvals, the real terminal, voice, files and usage, drawn as a night sky.

Home: the sun is an accretion disk that shows the 5-hour usage, projects orbit as planets, session cards with a NEEDS YOU chip, the model and the mode below
Your sessions as a sky.The sun is an accretion disk, and the disk is your 5-hour window: it drains as you spend it, goes dark at the limit and refills when the window resets. Projects orbit it as planets.
A session: the usage strip, the agent's edits and a build, and a NEEDS YOU card with Deny, Always and Allow
Approve from anywhere.Live output and the real terminal. Allow, deny or answer from the phone; risky commands get a second look.
Automations: each card is a plain-English sentence with its state and next run
Automations.Morning briefs, “carry on after the limit”, tests when the Mac is plugged in. Never on paid credits without your yes.
Dictation: the capsule's light curve rises with the voice while the words appear
Talk to it.Real-time speech recognition (Soniox, with your own key), and replies read aloud through your headphones.
The new-session sheet: a prompt first, then the project, model and permission mode as chips
Start anything.Type or say the prompt, then pick a project (found by a few letters), a model and a mode. Any provider: Anthropic, OpenRouter or your own gateway.
Statistics: hours the agents worked, tokens, sessions, and the last 30 days as a spiral galaxy
Honest statistics.Hours, tokens and sessions, not badges. Each day is a star in a galaxy.

More on the phone

The sky at the 5-hour limit: the disk is spent, a countdown says when it refills
Limits you can read. The disk empties, then a countdown.
The model picker in a session: every model the provider offers, with each one's own weekly use
Switch models in the chat.
A file download with its progress, a Cancel button and, when it is done, Share, Save and Open with
Files and downloads from the host.
A floating glass pop-up over a blurred scrim: an eyebrow, a title, one line, two pills
Calm pop-ups, one short line.
NEEDS YOU1 waiting

Approve Claude Code and Codex from your phone.

A command to run, a file to edit, a question, a plan to approve: each request reaches you with what it wants to do, on the phone, in its notification, in the menu bar and on the glasses. Allow or Deny it (or Always, for Claude Code). Risky commands get a second look, and Bypass mode asks you to think twice first.

How approvals work

Needs youauto-deny in 9mBash

HypernovaShip the Android build to the phone

$ git push origin main
Left unanswered for 10 minutes, a Claude Code request is denied, and Claude is told you're away, so it stops and waits for you.
TWO AGENTSClaude Code · Codex

Claude Code and Codex, as equals.

Use either one or both. Each session runs on its own agent with its own usage. The agent that leads is the sun; the other is a second, smaller star with its own sessions round it. Switch a conversation to the other agent mid-chat: it carries on in a new session in the same folder, with what you chose to carry over, linked to the old one.

CLAUDE USAGEClaude Code
5 hours43%2h 11m
7 days55%Tue 20:00
CODEX USAGECodex
5 hours38%3h 40m
7 days21%Fri 09:00
Switch to Codex

Switch to Codex

Codex goes on with this conversation in a new session in the same folder, with what you carry over as background. It does nothing until your next message.

Carry over

Claude Code and Codex together · Codex on your phone · Usage limits

IN THE MENU BARmacOS 14+

The phone's design, on the Mac.

A planet in the menu bar spins while anything works and shows a dot when something needs you. The popover has approvals, sessions in the phone's words, drawn usage meters that show where your pace is heading, Stay awake and automations.

The Mac app also installs and runs the service, sets up the claude shell integration and Tailscale, pairs phones with a QR code and lists the ones you trust, so you can forget one at any time.

The Mac popover: an approval with Deny, Always and Allow, sessions with their model and mode, projection meters for the 5-hour and weekly usage, Stay awake
The Mac popover while an automation runs: AUTO on its session, the run line under Sessions
ON YOUR GLASSESEven Realities G2

Glance, approve, listen.

Hypernova Lens runs on Even Realities G2 glasses. Glance at your sessions, hold the temple to talk, approve by tap or by voice (“approve push”), hear results read aloud and look through Telescope, in the glasses' own text and the phone's words. It connects through the Hypernova app on the same phone.

The glance on the G2 in the glasses' own font: hypernova/ and the time, 42% resets in 2h 11m in the corner, one line per session with its project, what it does and its age
The glance: every session, one line each.
Needs you on the G2: NEEDS YOU 0stems, auto-deny in 8m, wants to run git push origin main, tap allow, double tap deny
Needs you: tap to allow, double tap to deny.
A result card on the G2: the reply scrolls, with what changed and the tests
A result, with what changed and the tests.
Telescope on the G2: the page the agent built, dithered across the lens
Telescope: what the agent built, on the lens.

Claude Code on Even G2 glasses

ALSO ON THE PHONE9 more

The small things, done properly.

CONNECT YOUR WAY

Pair by scanning a QR code or tapping a link. On your Wi‑Fi the phone talks to the host directly over mutual TLS; away from home it uses your Tailscale, the Tailscale app or Hypernova's own built-in node. A connection log shows every decision.

NOTIFICATIONS YOU CAN ACT ON

Allow and Deny right on an approval's notification (after unlocking), a Reply field, and attention cards on Home you swipe away, with Undo.

FILES AND DOWNLOADS

Browse a session's folder, view a file, download it with progress and resume, then Share, Save or Open with it. Files with keys stay on the host.

UPDATES IN THE APP

The Mac hands the phone a newer app, and the app installs it, signed with the same key or not at all.

TELESCOPE

See what the agent built: the terminal, a local web page, an Android emulator or the iOS Simulator, a window or an image, refreshing live.

STAY AWAKE AND BACKPACK

Keep the Mac working with its lid closed in a bag, with battery and heat guards, and “+2 h” before Backpack ends.

LIMITS THAT EXPLAIN THEMSELVES

When a limit lifts, a “Continue now” button when Claude Code would carry on by itself, and other providers' credit and rate limits.

EVERYDAY TOOLS

The context ring and session cost, the agent's to-do list, Rewind, quick prompts, what changed (with diffs and a Commit button), the share target, shortcuts and widgets.

AFTER A RESTART

Sessions cut short by a reboot wait on Home with “Resume”. History keeps 30 days.

HOW IT WORKSno server in between

Your phone talks to your own machine.

A small service runs next to your agents, on your Mac or your Linux server. The phone reaches it directly on your Wi‑Fi, or over your own Tailscale network from anywhere. No Hypernova server carries your sessions.

YOUR PHONEAndroid 10+

The Android app

Kotlin and Jetpack Compose. Lens on the G2 talks only to this app on the same phone, which carries its calls.

  • Pairs once with a QR code or a link
  • Keeps a per-device token and certificate
YOUR HOSTMac or Linux

The service, next to your agents

It watches every Claude Code and Codex session through hooks, transcripts and Codex's own app server, and runs the phone's sessions in shared terminals you can also open on the host.

A Macthe menu bar app runs it and sets it up
A Linux serverthe hypernova command, a systemd user service

The full contract between the pieces is in PROTOCOL.md.

PRIVACYyours end to end

Self-hosted, and open source.

There is no Hypernova account and no Hypernova server that carries sessions. The only thing hosted is a small name service for pairing and a private name, and it never sees a session, a prompt or a file.

YOURS END TO END

Reached only by devices you paired.

The phone API listens on loopback and is reached through your tailnet or your Wi‑Fi's mutual-TLS listener, with a per-device token and certificate from pairing. Nothing is opened to the internet.

KEYS STAY HOME

Provider keys never leave the host.

Provider and Soniox keys are never logged, never sent to the phone, and only ever go to their own provider. Hypernova never reads your Claude login.

VOICE IS OPT-IN

Audio goes to Soniox only when you say so.

Only when you turn voice on with your own key. The Mac's own voices are the fallback for reading aloud.

GUARD RAILS

Nothing risky by accident.

Risky commands need their own verb by voice. Automations never run on usage credits or another paid provider unless you agree, and never close or copy your own sessions.

Apache License 2.0, all of it, Lens included. What runs and is stored where, and what Tailscale, Cloudflare and Let's Encrypt see: the threat model.

WHAT YOU NEED

Requirements

  • A host: a Mac with Apple silicon on macOS 14 or later, or a Linux machine on Ubuntu or Debian (x86_64 or arm64), including a VPS or a Docker container.
  • An agent: Claude Code, OpenAI's Codex (0.163.0 or later), or both.
  • An Android phone on Android 10 or later.
  • Optional: a Tailscale account to reach the host away from home (on the same Wi‑Fi you don't need one), Even Realities G2 glasses, and a Soniox API key for voice.
INSTALLv0.2.0

Download it here or from GitHub, then follow Setup.

The Mac app, the Android app and the Linux build are on this site and on GitHub Releases, with their checksums.

Install On Linux
GUIDES9 guides

Guides

One question each, answered from how the app really works.

FAQ18 answers

Questions, answered.

What is Hypernova?

A control room for Claude Code and OpenAI's Codex. A service on your host watches every session. The host is a Mac, with a menu bar app, or a Linux machine: a VPS, a home server, a PC or a Docker container, with the hypernova command. The Android app, the Mac's menu bar and Even Realities G2 glasses show the sessions: live output, approvals to answer, questions, usage and limits. You can start sessions, reply and approve from wherever you are. See Claude Code on your phone.

Is it free?

Yes. Hypernova is open source under the Apache License 2.0, Hypernova Lens included. You use your own Claude plan or API key (or another provider, such as OpenRouter or your own gateway), or your own Codex account.

Is it stable?

It's alpha software. It's used every day, but expect rough edges and changes between versions. A paired phone can drive the agents on your computer, so read SECURITY.md before you pair one.

Is Hypernova made by Anthropic, OpenAI or Even Realities?

No. Hypernova is an independent project and isn't affiliated with Anthropic, OpenAI or Even Realities. Claude and Claude Code are products of Anthropic; Codex is OpenAI's.

Do I need a Hypernova account or server?

No. There is no Hypernova account and no Hypernova server that carries sessions. Everything runs on your own host, a Mac or a Linux machine. The only hosted piece is a small name service at hypernova.observer for the pairing page and an optional private name for your host on your Wi‑Fi; it never sees sessions, prompts, files, pairing codes or tokens.

Does my code go through anyone else?

Sessions live on your host, the Mac or Linux machine. The phone reaches it directly on your Wi‑Fi over mutual TLS, or over your own Tailscale network, where traffic between your devices is end-to-end encrypted. Provider and Soniox keys stay on the host and are never sent to the phone. Your agent still talks to its own provider, exactly as it does in a terminal. The security model lists what each outside party sees.

All the questions