gitwtfhub

wtf is codor?

rjx18/codor — explained in plain English

Analysis updated 2026-05-18

206TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

Codor gives multiple AI coding agents, such as Claude Code and Codex, one shared local channel to coordinate work in, while all data stays on your own machine.

Mindmap

mindmap
  root((codor))
    What it does
      Shared channel for agents
      Local data storage
      Native sessions preserved
    Setup
      One command install
      systemd or LaunchAgent
      Windows Task Scheduler
    Remote access
      Tailscale private access
      Pairing via QR code
    Existing sessions
      Join a live session
      Adopt or attach
    Audience
      Developers using multiple agents

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

Why would anyone build with this?

REASON 1

Coordinate several AI coding agents like Claude Code, Codex, and Cursor in one shared local channel.

REASON 2

Attach an already-running Claude Code or Codex session into a channel without restarting it.

REASON 3

Access your local Codor instance remotely and privately from your phone using Tailscale.

What's in the stack?

TypeScriptNode.jspnpm

How it stacks up

rjx18/codordexhorthy/shannonerezshahaf/lore
Stars206204208
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdevelopergeneral

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Node.js 22.12 or newer and at least one authenticated agent CLI such as Claude Code or Codex, still in alpha.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Codor gives multiple AI coding agents, like Claude Code, Codex, Cursor, and Gemini, one shared channel to work in together while each agent keeps its own native session and context. Messages, mentions, tool evidence, files, unread state, and run history all stay stored on your own machine rather than going through a hosted service. Getting started is a single command that installs Node.js dependent tooling, checks your computer, prepares private files, asks how your browser should connect, starts Codor as a background service, and then shows a QR code, a URL, and an eight-character pairing code you use to connect. On Linux it runs as a systemd user service, on macOS as a LaunchAgent, and on native Windows as a hidden per-user Task Scheduler service, so no terminal window needs to stay open. Windows users running WSL2 can set it up inside WSL and open it from a Windows browser. You can access Codor remotely and privately from another device, like your phone, using Tailscale, without exposing it to the public internet. If you already have a Claude Code or Codex session running, you can add that live session into a Codor channel without restarting it, and later hand control of that session back and forth between your terminal and Codor. Codor supports upgrading through the same install command, and offers development mode, service status checks, and log viewing for people running it as a self-hosted service. The project is still in an early alpha stage, so some features may be unfinished or change frequently between updates. This is a TypeScript project aimed at developers who use multiple AI coding agents and want a single, local, persistent place to coordinate their work. It is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through installing Codor and connecting my browser with the pairing code.
Prompt 2
Show me how to join an existing Claude Code session into a Codor channel using codor join.
Prompt 3
Set up Codor to run privately over Tailscale so I can access it from my phone.
Prompt 4
Explain the difference between codor join, codor adopt, and codor attach.

Frequently asked questions

wtf is codor?

Codor gives multiple AI coding agents, such as Claude Code and Codex, one shared local channel to coordinate work in, while all data stays on your own machine.

What language is codor written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, pnpm.

What license does codor use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codor to set up?

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

Who is codor for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.