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, CSRF, IP block, path safety
• Audit Log — what gets recorded, how to filter (v0.15.0+)
• Troubleshooting — common errors + fixes
• Upgrade Guide — version migration paths

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

Layer	Version
Server image	siamakerlab/vibe-coder-server:latest (linux/amd64; current = v0.15.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.13.0 added ApiPath.claudeConsoleCancel (turn cancel). Android shared/ synced in client v0.6.11.

Highlights of v0.13.0 — v0.15.0

Version	Headline change
v0.15.0	Operational /audit log + file syntax highlighting + Android wire sync done
v0.14.1	New project CLAUDE.md template lists installed build-tool paths so wrappers don't re-download Gradle
v0.14.0	Breaking — SQLite → PostgreSQL sidecar. Fresh-start required (workspace preserved)
v0.13.0	Phase 1 batch — turn cancel + tool render + file edit + prompt templates + General Chat
v0.12.4	Security audit — CSRF / WS Origin / IP block / FK cascade / template safety

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.