Skip to content

Home

Jump to bottom
comfuture edited this page Aug 10, 2026 · 1 revision

Codori Wiki

Codori is a self-hosted remote coding control plane for the Codex app-server. The README covers installation and the quick tour. This wiki holds everything else.

Getting around

Page What it covers
Remote Access Tailscale Serve, HTTPS for XR and microphone, direct tailnet binding
Realtime Voice Push-to-talk, voice companion, voice selection, transcripts
Immersive XR WebXR workspace, entry requirements, headset notes
Configuration ~/.codori/config.json, CLI flags, ports, idle shutdown
Background Service launchd, systemd, Task Scheduler, updates
Runtime Model Remote-control daemon, managed fallback, workspace lifecycle
Settings and UI Settings workspace, notifications, file explorer, avatars
Security Notes Trust boundary and non-goals
Development Monorepo layout, local builds, tests, release flow

The short version

Run one command on the machine that already holds your repositories:

codori start --root ~/Project

Codori discovers every directory with a direct .git child under that root, serves a dashboard, and connects each project or chat to a shared Codex app-server backend on demand.

Project discovery rules

Given a root such as ~/Project, Codori treats any descendant directory with a direct .git child as a project:

  • ~/Project/codori/.git -> project id codori
  • ~/Project/team/api/.git -> project id team/api

Recursive scanning skips common heavy directories: node_modules, .git, .nuxt, .output, dist, build, and coverage.

Design constraints

Codori holds a few lines deliberately:

  • Project-first. One root directory, many Git repositories, one control plane.
  • Thin management layer. Codori reuses the first-party Codex remote-control daemon when it is ready and manages an app-server fallback only when necessary.
  • Safe runtime model. One Codori server selects one shared app-server backend, while each project or chat stays a logical workspace.
  • Bring your own network. Private access is your responsibility.
  • Focused surface area. Project discovery, runtime control, and Codex access, without absorbing adjacent infrastructure concerns.

Practical recommendation

For most setups:

  1. Run Codori on a workstation or home server that already has your repositories.
  2. Join that host and your laptop to the same Tailscale tailnet.
  3. Run codori start --root ~/Project.
  4. Open the private MagicDNS HTTPS URL that Codori prints.

Clone this wiki locally