codex-linker

name	codex-linker
description	Use this skill when setting up, validating, or explaining codex-linker in this repository. It covers onboarding multiple Codex ChatGPT OAuth accounts with separate CODEX_HOME auth files, shared non-auth config symlinks, shell aliases, doctor checks, and optional usage/reset-ticket status checks.

codex-linker

Set up multiple Codex CLI ChatGPT OAuth accounts on one machine while sharing the same non-auth Codex configuration.

Safety rules

• Never copy, symlink, print, or modify auth.json.
• Never run status --api unless the user explicitly asks for API-backed usage/reset-ticket checks.
• doctor is local filesystem validation only.
• status without --api is local-only and must not make network calls.
• Do not print access tokens, account IDs, raw private API payloads, or full auth file contents.

One-time repo setup

From the repository root:

bun install
bun run build
bun link

Three-account onboarding

Account 1 remains the default Codex home:

~/.codex

Create secondary homes:

codex-linker setup --accounts 3

Login account 2 and account 3:

CODEX_HOME="$HOME/.codex-accounts/subs2" codex login
CODEX_HOME="$HOME/.codex-accounts/subs3" codex login

Link shared non-auth config and verify:

codex-linker link subs2
codex-linker  subs3
codex-linker doctor subs2
codex-linker doctor subs3