Skip to content

Releases: KarrixLee/nomo

Release list

v1.0.0

Choose a tag to compare

@KarrixLee KarrixLee released this 13 Jul 23:21

1.0 — first stable release

Nomo mirrors your Claude Code and OpenAI Codex session milestones to the Nomo iPhone app as a Live Activity / Dynamic Island — working, needs-your-approval, done — so you can step away from the terminal and still know when an agent needs you or has finished.

Everything is end-to-end encrypted. Pairing is a single QR-code scan (or a short typed code) that derives one shared key held only by your phone and computer — an authenticated ECDH ratchet gives forward secrecy, and every session update is sealed with AES-256-GCM before it leaves your machine. The Cloudflare relay Worker is a blind fan-out relay: it routes by pairing id but can't read a single field — not the title, machine name, status, or even which agent produced the event.

What's in 1.0:

  • One pairing, both agents. Claude Code (nomo-cc) and native Codex (nomo) ship from one shared plugin/ directory and share credentials, key, watchdog, and Live Activity.
  • QR + typeable pairing. Six-word BIP39 code (PBKDF2-SHA256, 600k iterations) or QR scan, with opt-in code reveal — the code never touches the terminal by default.
  • Live Activity states including working, needs-attention, and permission/approval alerts, plus a liveness watchdog that posts a corrective done/end when a terminal closes without a clean exit.
  • Lifecycle hooks wired automatically on Claude Code (no settings.json edits); Codex hooks ship inert until you trust them once.
  • Skills / commands: pair, unpair, status, reset.
  • Zero npm dependencies — Node built-ins only; runs under bun or node ≥ 18 via a run.sh shim. plugin/dist/*.mjs is committed (marketplace installs are a plain git clone).

Install

Claude Code — from inside Claude Code:

/plugin marketplace add KarrixLee/nomo
/plugin install nomo-cc@nomo
/nomo-cc:pair

OpenAI Codex (≥ 0.142) — from inside a Codex session (also works in the Codex desktop app):

codex plugin marketplace add KarrixLee/nomo
codex plugin add nomo@nomo

Then run /hooks and trust the six Nomo entries once, and pair with $nomo-pair. One pairing is shared with Claude Code if both agents run on the same machine.

Upgrade

Re-run the marketplace add/update for your agent to pull v1.0.0. Existing pairings are preserved — no re-pair needed. The Codex hook command lines are byte-stable, so a previously trusted install stays trusted.