Home

Vibe Coder Server — Wiki

Self-hostable Android development server orchestrating Claude Code, Gradle, and Git as child processes. Browser-only operation, optional Android companion client. Ships as a two-container docker compose stack (vibe-coder-server + postgres:17-alpine) since v0.14.0.

Table of contents

Getting started

• Quick Start (Docker) — 3-minute setup
• Data Volumes & Backup — unified ./vibe-coder-data/ layout
• Architecture Overview — modules, child processes, persistence

Build environment

• Build Environment Setup — Android SDK / Gradle / Node
• Claude Authentication — terminal / file upload / API key / web OAuth
• MCP Catalog — 60+ servers, checkbox UI, per-MCP tokens
• Git Integration — PAT + SSH key for private repo clone

API for clients (Android, CLI, scripts)

• REST API Reference — every endpoint with curl + Retrofit examples
• WebSocket Protocol — auth flow + frame types
• Android Client Guide — repository pattern + auth + key flows

Operations

• Security Model — auth, path safety, sandboxing
• Troubleshooting — common errors + fixes
• Upgrade Guide — version migration paths

Project status (2026-05-24, v0.14.0)

Layer	Version
Server image	siamakerlab/vibe-coder-server:latest (multi-arch amd64/arm64; current = v0.14.0)
Sidecar	postgres:17-alpine (v0.14.0+)
Base OS	Ubuntu 24.04 LTS (Noble Numbat)
Kotlin	2.2.20 / Ktor 3.1.2 / JDK 17 / Exposed 0.55.0 + PostgreSQL JDBC 42.7.4
Wire	v0.14.0 adds ApiPath.claudeConsoleCancel (turn cancel) — Android shared/ sync required

Repositories

• Server: https://github.com/siamakerlab/vibe-coder-server (this repo)
• Android client: (planned) vibe-coder-android — same shared/ module (DTOs / ApiPath / WsFrame) must stay in sync. See Android Client Guide for the integration playbook.

License

GNU Affero General Public License v3.0. SaaS deployments must release modifications under the same license.