# codvps

By Hao-Wei Lee

A headless, CLI-first host manager for native Claude Code and Codex remote control on Linux VPS instances.

Source: https://github.com/egginsect/codvps

Canonical: https://hwl.dev/work/codvps
Last content review: 2026-10-07

## How can a remote host stay useful across coding sessions?

codvps brings authentication, repositories, model synchronization, and host configuration into one command-line workflow. The coding tools run on the VPS and communicate directly with their providers.

## Design decisions

### Keep the native tools

Manage remote Claude Code and Codex environments without proxying their assistant traffic.

### Make setup inspectable

The installer verifies the release checksum and version, then shows host changes before asking to provision them.

## Evidence and boundaries

Evidence below summarizes the public project documentation, not an independent audit. Source README: https://github.com/egginsect/codvps/blob/main/README.md

### A documented headless workflow

Status: Implemented

The public README documents version-pinned installation, component selection, and GitHub device login without a terminal.

Source record: Public README: Install and Privacy
Citation: https://hwl.dev/work/codvps#host-workflow

## Current limitations

- Pre-alpha: command interfaces and behavior may change.
- Host provisioning targets Ubuntu/Debian and requires a sudo-capable login user.
- This case study does not claim production reliability or measured performance.

## Synthetic walkthrough

Illustrative data; not a live service or measured result.

### 1. Choose the host setup

An illustrative setup for a personal Linux VPS, not a recorded run.

Input: An Ubuntu/Debian VPS and the desired coding CLI components.

Decision: Inspect the release and planned provisioning changes before installation.

Output: A host configured for the selected native coding tools.

### 2. Authenticate on the host

Use the documented GitHub device flow when working without an interactive terminal.

Input: codvps login github

Decision: Complete GitHub authentication through the displayed device flow.

Output: GitHub access for user-initiated repository operations on the VPS.

A public prototype landing page is not available yet.

Contact: https://www.linkedin.com/in/hao-wei-lee-b7ba2b37/