# codex-remote

**Repository Path**: rubekid/codex-remote

## Basic Information

- **Project Name**: codex-remote
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Codex Remote

Self-hosted, multi-user remote console for a Codex Desktop host.

## Components

- `server`: Spring Boot service for authentication, RBAC, task metadata, auditing, and WebSocket routing.
- `web`: Vue 3 and TypeScript operations console.
- `agent`: Windows service that connects the local Codex App Server to the public service over WSS.
- `deploy`: Nginx, systemd, database, and deployment examples for CentOS.
- `docs`: Architecture, protocol, security, and operations notes.

The browser never connects directly to Codex Desktop. The Windows agent only creates
outbound connections, and the public service authorizes every user action before it is
forwarded to the host.

## Current status

- Responsive Vue task console with login, Markdown/code rendering, attachments, approval persistence, and live output
- Create, stop, rename, archive, restore, search, filter, and resume Codex tasks from the browser
- RuoYi 3.9.2 Spring Boot 3 backend on Java 17
- `ruoyi-codex` module with host, task, message, and prompt APIs
- Flyway-managed schema for Codex tables, message deduplication, attachments, and task lifecycle
- CentOS Nginx/systemd/application configuration examples
- Go Windows Agent 0.3.0 with Codex App Server stdio bridge, WSS reconnect, history sync, streaming deltas, and lifecycle controls
- Versioned `/codex/client/v1` API, OpenAPI contract, incremental message sync, authenticated attachment download, and TypeScript SDK for Electron/mini-program clients
- Durable command queue, agent enrollment/token rotation, and approval response workflow
- CentOS release, database, Nginx, systemd, and Windows installation scripts

## Local development

Frontend:

```powershell
cd web
npm install
npm run dev
```

Backend (Java 17 and Maven required):

```powershell
cd server
mvn -pl ruoyi-admin -am package -DskipTests
```

See `docs/architecture.md`, `docs/agent-protocol.md`, `docs/client-api-v1.md`, and `deploy/README.md` before
connecting a Windows host or changing production infrastructure.