code Desktop Service

code-desktop-service v0.1.0 preview

This preview release publishes the desktop service source and setup documents.

What Is Included

Local HTTPS management console at https://localhost:37631.
QR-code pairing for trusted mobile clients.
WebSocket session sync for paired clients.
Codex Desktop/App Server integration.
Local CA and service certificate generation.
User-triggered trust installation from the local management console.
Bonjour/mDNS discovery with TLS identity metadata.
Project-root management.
Media asset and local web preview management.
macOS LaunchAgent startup toggle.
Windows runtime support, Codex binary discovery, project-root picker, and current-user certificate trust installation.

Install From Source

git clone https://github.com/lyz1022/code-desktop-service.git
cd code-desktop-service
corepack enable
corepack prepare pnpm@9.15.4 --activate
pnpm install --frozen-lockfile
pnpm --filter @code/protocol build
pnpm --filter @code/mac-service build
pnpm --filter @code/mac-service start

Open the local management console:

https://localhost:37631

If the browser shows a certificate warning, open the management console from the desktop machine and use the Install Trust action. Trust installation is restricted to loopback requests.

Pairing

Start code-desktop-service on the desktop machine.
Open https://localhost:37631.
Install local trust if needed.
Generate a pairing QR code.
Open the paired mobile client and scan the QR code.
Confirm the desktop identity and complete pairing.

Public Documents

Desktop Service Setup Guide: https://lyz1022.github.io/code-desktop-service/desktop-service-install-guide.html

Known Limits

This preview release is source-first. It does not include packaged macOS or Windows installers.
macOS has the most complete startup and local capture support.
Windows support focuses on service runtime compatibility, data directories, Codex binary discovery, project-root management, and certificate trust installation.