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+)
• Conversation History — prompts/responses persisted in PG (v0.16.0+)
• Email Notifications — SMTP config + triggers (v0.17.0+)
• Git Workflow — read-only diff/log + commit/push (v0.18.0+)
• Android Emulator — diagnostics, manual launch (v0.19.0+)
• Troubleshooting — common errors + fixes
• Upgrade Guide — version migration paths

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

Layer	Version
Server image	siamakerlab/vibe-coder-server:latest (linux/amd64; current = v0.19.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
Email	Jakarta Mail 2.1.3 + Angus 2.0.3 (v0.17.0+)
Wire	v0.18.0 added ApiPath.gitCommit + RegisterProjectRequestDto.templateId. Android shared/ synced in client v0.6.13.

Highlights of v0.12.4 — v0.19.0

Version	Headline change
v0.19.0	Phase 5 — Android Emulator scaffolding: /emulator 진단 + ADB install + 수동 launch 가이드
v0.18.0	Phase 4 — Git push (POST /git/commit) + 프로젝트 templating (6 종 starter prompts)
v0.17.0	Phase 3 — SMTP 이메일 알림 + 빌드 결과 자동 알림 + /settings/email
v0.16.0	Phase 2 — Prompt/Response 영구 히스토리 (PG conversation_turns) + /projects/{id}/history + /chat/history
v0.15.0	Phase 1 — Operational /audit log + file syntax highlighting + Android wire sync
v0.14.1	New project CLAUDE.md template lists installed build-tool paths
v0.14.0	Breaking — SQLite → PostgreSQL sidecar (fresh-start; workspace preserved)
v0.13.0	Turn cancel + tool render + file edit + prompt templates + General Chat
v0.12.4	Security audit — CSRF / WS Origin / IP block / FK cascade

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.