Home

Vibe Coder Server — Wiki

Self-hostable Android development server orchestrating Claude Code, Gradle, and Git as child processes. Single Docker container, browser-only operation, optional Android companion client.

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-23, v0.10.0)

Layer	Version
Server image	siamakerlab/vibe-coder-server:0.10.0 (multi-arch amd64/arm64)
Base OS	Ubuntu 24.04 LTS (Noble Numbat)
Kotlin	2.2.20 / Ktor 3.1.2 / JDK 17
Wire	19 new APIs in v0.10.0 (Env / Claude auth / MCP / Git)

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.