🚀 Vibe Stack

Production-ready Docker setup for Vibe-Kanban + Claude Code AI coding platform.

✨ Features

• 🤖 Vibe-Kanban - AI agent orchestration platform
• 💻 code-server - Browser-based VS Code
• 🔐 Secure Secrets - Project secrets isolated from AI agents
• 📦 Persistent Data - Projects and settings survive restarts
• 🐳 One Command Deploy - Get started in minutes

📋 Prerequisites

• Docker & Docker Compose
• Anthropic/Claude Account

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/halilbarim/vibe-stack.git
cd vibe-stack

2. Configure Environment

cp .env.example .env
# Edit .env with your settings

3. Configure Claude (API Keys)

cp agents/claude/settings.json.example agents/claude/settings.json

Edit agents/claude/settings.json with your API key:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

4. Start Services

docker-compose up -d

5. First-time Claude Login

docker exec -it vibe-server su - node -c "claude --dangerously-skip-permissions"

1. Select theme with arrow keys
2. Copy the login URL from terminal
3. Open in browser, login with your Anthropic account
4. Click "Authorize" and copy the token
5. Paste token in terminal and press Enter
6. Type exit twice to leave container

6. Access Services

Service	URL	Password
Vibe-Kanban	http://localhost:4000	-
VS Code	http://localhost:8443	From .env file

📁 Project Structure

vibe-stack/
├── docker-compose.yml    # Main configuration
├── .env                  # Environment variables
├── agents/
│   └── claude/           # Claude Code settings (accessible by agent)
│       └── settings.json
├── secrets/              # Project secrets (NOT accessible by agent)
│   └── your-project/
│       └── .env.*
├── HELPER.md             # Docker command reference
└── README.md

🔐 Security

• Project Secrets: Stored in /root/secrets - agent cannot access
• Claude Config: Stored in agents/claude - agent can access (required)
• SSH Keys: Mounted read-only

🛠️ Common Commands

# Start all services
docker-compose up -d

# Stop all services
docker-compose down

# View logs
docker-compose logs -f

# Restart services
docker-compose restart

# Enter container shell
docker exec -it vibe-server bash

# Check status
docker-compose ps

📊 Resource Usage

Container	Image Size	RAM
vibe-kanban	~200 MB	~300 MB
code-server	~500 MB	~400 MB

🔧 Configuration

Add Project Secrets

1. Create folder: secrets/your-project/
2. Add env files: .env.development, .env.production
3. Restart: docker-compose restart vibe-kanban

Secrets are automatically copied to /repos/your-project/.env.*.local

code-server Password

Set in .env:

CODE_SERVER_PASSWORD=your-secure-password

Using GLM-4 / Alternative LLMs (via z.ai Proxy)

This setup supports using zhipu.ai GLM-4 models as an alternative to Claude. Edit agents/claude/settings.json:

{
  "hasAcknowledgedDangerousSkipPermissions": true,
  "hasCompletedOnboarding": true,
  "theme": "dark",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-z-ai-api-key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

Model	Maps To
Haiku	glm-4.5-air
Sonnet	glm-4.7
Opus	glm-4.7

📖 Documentation

• HELPER.md - Docker command reference

⚠️ Important Notes

• docker-compose down -v deletes all data - use with caution
• Claude login required after down -v or first setup
• Normal restarts preserve all data

📄 License

MIT License - See LICENSE for details.

---

Made with ❤️ for AI-powered development