dicnunz

dicnunz / codex-relay

Public

Text your Mac. Codex works.

dicnunz.github.io automation codex codex-cli launchagent local-first
10
0
100% credibility
Found Apr 28, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Codex Relay bridges private Telegram messages from a phone to run tasks on a local Codex AI installation on macOS, returning results via chat.

How It Works

1
📱💻 Discover the bridge

You hear about a simple way to text your Mac's smart helper from your phone while away from your desk.

2
🖥️ Set up on your Mac

Follow a few easy steps to install the bridge that connects your phone chats to your Mac's helper.

3
🔗 Link your private chat

Connect only your personal phone chat so it's secure and just for you.

4
📲 Send a hello message

From your phone, text a quick check to see if your Mac is listening.

5
✨ Get smart replies

Your Mac's helper responds right away with status or starts working on your request.

6
🖼️ Share screens or tasks

Send pictures, ask to check folders, or grab your Mac screen from your phone.

✅ Control from anywhere

Now you can give tasks to your Mac's smart helper anytime, anywhere, with replies coming back to your phone.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is codex-relay?

Codex-relay on GitHub turns Telegram into a remote control for your Mac's local Codex CLI. Send a DM from your phone—like inspecting a repo, analyzing a screenshot, or running tests—and it triggers Codex on your Mac with full file, tool, and account context, then replies directly to Telegram. Built in Python for macOS, it uses a LaunchAgent for always-on service without hosted relays or screen sharing.

Why is it gaining traction?

Unlike VNC mirrors or cloud agents, codex relay service keeps everything local and private—no extra logins, no rate limits beyond your OpenAI account. Developers dig the slash commands (/alive, /screenshot, /cd path, /tools) for quick status checks, thread switching, and image attachments, plus a menu bar app for Mac-side control. It's a lightweight bridge for github text format tasks, like prompting Codex on repo changes while away from your desk.

Who should use this?

Mac devs with the Codex app who code on the go and need phone access to local repos—think inspecting git diffs, screenshot analysis, or small test runs without firing up a laptop. Ideal for solo hackers debugging from bed or travel, or anyone tired of hosted github text to speech ai wrappers that leak context.

Verdict

Try it if you're a Codex Mac user seeking phone-remote power—install script and doctor checks make setup straightforward despite 10 stars and 1.0% credibility score. Early-stage with solid docs and smoke tests, but report blockers via issues for polish.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.