Codex Remote Companion Workstation Daemon
=========================================

This daemon keeps Codex running on your workstation while the web app acts as its remote console.

Bundle contents
---------------
- macos-arm64/companiond
- macos-amd64/companiond
- windows-amd64/companiond.exe

What you need
-------------
- Codex installed on the workstation
- A pairing code generated in the CodexCommander web app

No manual environment setup is required
---------------------------------------
The daemon is preconfigured to reach CodexCommander. On first launch it will ask for the pairing code, redeem it, save the device token locally, and then connect automatically on future launches.

Install
-------
macOS
- Create a folder such as ~/Applications/CodexRemoteCompanion
- Copy the matching companiond binary into that folder
- Make it executable once: chmod +x companiond
- If macOS blocks it because the binary is not signed, first try Control-click the file in Finder, choose Open, then click Open again.
- If macOS still blocks it and you trust the download, run: xattr -d com.apple.quarantine companiond

Windows
- Create %LOCALAPPDATA%\CodexRemoteCompanion\bin
- Copy companiond.exe into that folder

First run
---------
1. Open https://codexcommander.com and sign in.
2. Create a pairing code in the Pairing section.
3. Run the daemon from a terminal.
4. Paste the pairing code when prompted.

macOS example:

  ./companiond

Windows PowerShell example:

  .\companiond.exe

After pairing
-------------
- The daemon stores its connection details locally.
- Future launches do not need the pairing code again unless you revoke the device.
