git404hub

what is codex-mini fr?

coimgrain/codex-mini — explained in plain English

Analysis updated 2026-05-18

26HTMLAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A phone to Mac bridge that lets you control a Codex Desktop AI coding session from your phone's browser.

vibe map

mindmap
  root((Codex Mini))
    What it does
      Phone to Mac bridge
      Mirrors Codex replies
      Sends text and images
    Tech stack
      macOS
      Chrome DevTools Protocol
    Use cases
      Remote Codex control
      Mobile coding on the go
    Audience
      Developers
      Codex Desktop users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Send prompts and images to a Codex Desktop session on your Mac from your phone's browser.

VIBE 2

Monitor Codex's replies and tool calls remotely while away from your Mac.

VIBE 3

Use Pro's remote relay to control your Mac's Codex session from outside your home network.

what's the stack?

HTMLmacOSChrome DevTools Protocol

how it stacks up fr

coimgrain/codex-mini0xovo/litedocaffaan-m/behavioral_rl
Stars262626
LanguageHTMLHTMLHTML
Setup difficultymoderateeasymoderate
Complexity3/51/54/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Codex Desktop already installed and logged in on an Apple Silicon Mac, conflicts with other CDP based control tools.

Source available for personal and non-commercial use only, with required attribution, commercial use needs the author's written permission.

in plain english

Codex Mini is a bridge tool that lets you use a phone's web browser to control a Codex Desktop session running on a Mac. You open a local web page on your phone, type or send an image, and that input gets pasted into the active Codex conversation on your Mac. The web page then mirrors Codex's replies, including its reasoning steps and tool calls, back to your phone in real time. There are two ways to get it: an open source version in this repository, meant for people comfortable running their own server and doing further development, and a prebuilt DMG application for Apple Silicon Macs that the author maintains directly and updates first with new features. The current release, version 4.0.3, switches to a faster control method built entirely on Chrome DevTools Protocol, letting it run quietly in the background, but the README warns that anyone upgrading from the earlier Beta version must fully uninstall it first, including its background service, or the new version may fail to control Codex properly. It also warns that this new version conflicts with other tools that control Codex Desktop through the same protocol, such as a separate project called Codex++, and that only one such tool can be active at a time. On the local network, the phone connects directly to the Mac and the feature is free to use. A paid Pro tier unlocks access from outside the local network by relaying the connection through the author's server, while keeping your Codex login, conversation history, and typed input on your own Mac, the server's stated role is limited to routing the connection and checking device authorization, not reading your conversations. The README states the project is source available for non-commercial use only. You may read, modify, and redistribute it with attribution, but commercial use, including paid hosting or resale, requires the author's written permission.

prompts (copy fr)

prompt 1
Walk me through installing Codex Mini v4.0.3 and removing the old Beta version safely.
prompt 2
Explain the security model of Codex Mini's Pro remote relay and what stays on my Mac.
prompt 3
Help me add Codex Mini to my iPhone home screen for the full app-like experience.

Frequently asked questions

what is codex-mini fr?

A phone to Mac bridge that lets you control a Codex Desktop AI coding session from your phone's browser.

What language is codex-mini written in?

Mainly HTML. The stack also includes HTML, macOS, Chrome DevTools Protocol.

What license does codex-mini use?

Source available for personal and non-commercial use only, with required attribution, commercial use needs the author's written permission.

How hard is codex-mini to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-mini for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.