Not Codex is independent and is not affiliated with, sponsored by, or endorsed by OpenAI, Anthropic,
Cursor, OpenCode, xAI, T3 Tools, or T3 Code. Codex and OpenAI are OpenAI marks; Claude and Claude Code
are Anthropic marks; Grok is an xAI mark; Cursor, OpenCode, T3 Tools, and T3 Code are marks of their
respective owners.
[!IMPORTANT]
Not Codex is an early work in progress. Expect sharp edges, changing APIs, and incomplete releases.
Use it on repositories you can recover and review agent actions before granting broad access.
Why Not Codex?
Coding agents are powerful, but their native interfaces, session models, and operational behavior are
different. Not Codex gives them one predictable product surface without hiding what they do:
- Provider-neutral sessions — choose a configured provider instance and model per thread.
- Real repository workflows — branches, isolated worktrees, checkpoints, diffs, stacked changes,
pull-request preparation, and source-control status live beside the conversation.
- Inspectable execution — streaming events, tool activity, approvals, user-input requests, and
failures are represented in one durable orchestration model.
- Desktop, web, and mobile surfaces — work locally, connect remotely, and follow active work from
another device.
- Built for failure — ordered transports, reconnect recovery, persisted projections, and explicit
runtime receipts favor correctness over optimistic UI state.
- Durable Automations — run tasks now, once, on an interval, or on a weekly calendar; use bounded
follow-until-complete turns, project checks, isolated worktrees, notifications, and optional branch or
pull-request publishing without leaving the ordinary thread model.
- Agent-loop integrations — author with Monkey D. Loopy context and verified recipes,
infer drafts from existing loops, and run execution-ready LoopSpecs through ordinary Not Codex
threads; optionally accept root-jailed LoopAny deliveries while Not Codex remains the local
execution authority.
Product Tour
Supported Providers
Install and authenticate at least one provider before starting Not Codex.
Provider support is implemented through adapters. Generic contracts route through configured provider
instances and do not depend on provider-native thread or event shapes.
Quick Start: Build from Source
Not Codex does not currently publish an npm package, signed desktop download, or public hosted app.
Review and build the source to try this early work in progress.
Requirements:
- Node.js 24.13 or newer within the supported Node 24 release line
- Vite+
- at least one authenticated provider CLI
Install Vite+ on macOS or Linux:
curl -fsSL https://vite.plus | bash
On Windows PowerShell:
irm https://vite.plus/ps1 | iex
Then install dependencies and start the development environment:
git clone https://github.com/MaTriXy/not-codex.git
cd not-codex
vp install
vp run dev
Useful commands:
| Command | Purpose |
|---|
vp run dev | Start the local development environment |
vp run dev:desktop | Start the desktop app workflow |
vp check | Run formatting and lint checks |
vp run typecheck | Typecheck every workspace package |
vp run test | Run package test scripts |
vp run build | Build apps and packages |
Architecture at a Glance
Web / Desktop / Mobile clients
│ typed RPC + ordered subscriptions
▼
Not Codex environment server
orchestration · persistence · VCS · previews
│ provider-neutral adapter boundary
▼
Codex · Claude Code · Cursor · Grok Build · OpenCode · Pi · …
The environment server is the local execution authority. It owns provider processes, repository access,
durable thread state, checkpoints, and source-control workflows. Not Codex Connect can make an environment
reachable and deliver status, but provider execution does not move into the cloud.
Read the architecture overview,
provider architecture, and
remote-access architecture for the full trust boundary.
For external scheduling and bounded loop execution, see the
integrations guide.
Repository Map
| Path | Responsibility |
|---|
apps/server | Node.js environment server, orchestration, provider sessions, persistence, VCS |
apps/web | React/Vite application and responsive product UI |
apps/desktop | Electron desktop host and packaging |
apps/mobile | Expo/React Native companion app |
packages/contracts | Shared Effect Schema contracts; no runtime logic |
packages/client-runtime | Shared client connection, RPC, and state runtime |
packages/shared | Cross-runtime utilities through explicit subpath exports |
infra/relay | Optional Not Codex Connect relay infrastructure |
docs | Architecture, operations, provider, user, and reference documentation |
Project Status and Roadmap
The current foundation includes multi-provider runtime adapters, event-sourced orchestration, desktop/web/
mobile clients, remote pairing, terminal and preview surfaces, Git worktree/checkpoint/diff workflows, and
a provider-neutral Automations platform. Automations are local-first, restart-safe, and visible as ordinary
threads with durable timelines. Read the user guide and
architecture. The integrations platform adds Monkey D. Loopy
authoring context, verified recipes, deterministic inference, and guarded validation/execution, plus an
optional LoopAny delivery connector, without creating a second agent runtime outside the ordinary Not
Codex harness. See the Monkey D. Loopy integration guide for the
runtime boundary and safety policy.
Contributing
Focused fixes, tests, documentation, reliability improvements, and performance work are welcome. Discuss
non-trivial features in an issue before investing in a large change. Every pull request must pass:
vp check
vp run typecheck
vp run test
Read CONTRIBUTING.md and the Code of Conduct before contributing.
Report vulnerabilities privately according to SECURITY.md.
Origin, License, and Brand
Not Codex is an independent derivative project based in part on
T3 Code, used under the MIT License. The name began as a playful build
challenge for SOL: create the best independent Not Codex experience possible.
Source code is available under the terms in LICENSE. Attribution and third-party notices are in
NOTICE.md. The Not Codex name, logo, app icons, and visual identity are covered separately by
TRADEMARKS.md; the MIT source license does not grant rights to those brand assets.
Not Codex is independent and is not affiliated with, sponsored by, or endorsed by OpenAI, Anthropic,
Cursor, OpenCode, xAI, T3 Tools, or T3 Code. Codex and OpenAI are OpenAI marks; Claude and Claude Code
are Anthropic marks; Grok is an xAI mark; Cursor, OpenCode, T3 Tools, and T3 Code are marks of their
respective owners.
