master-ai/AI_CAPABILITIES.md

Vibn AI Capabilities (Condensed)

Note: The definitive, ground-truth list of AI capabilities and instructions is maintained in the codebase at vibn-frontend/lib/ai/vibn-tools.ts.

Core Architecture

Vibn uses an MCP (Model Context Protocol) adapter to expose backend systems to the AI. The primary systems are:

1. Coolify: For orchestrating Docker containers, PostgreSQL databases, reverse proxies (Traefik), and deploying third party apps.
2. Gitea: For hosting source code and managing repositories.
3. Dev Containers: Persistent, per-project Docker environments (vibn-dev-*) where the AI can read, write, and execute code interactively before shipping.

Tool Categories

• Workspace & Identity: Retrieve Gitea credentials and workspace metadata.
• Projects & Planning: Create projects, read/write objective documents (plan_vision_set), manage tasks, log decisions.
• File System (fs_*): Read, write, edit (with line-number granularity), grep, and tree codebase directories.
• Shell (shell_exec): Run terminal commands inside the dev container (e.g. npm install).
• Dev Servers (dev_server_*): Spin up background processes (like npm run dev), view their logs, and return live Preview URLs (*.preview.vibnai.com) backed by Traefik.
• Apps & Databases: Create, list, configure, and delete Coolify applications and databases.
• Domains & Auth: Manage DNS records via OpenSRS and deploy auth providers (NextAuth, Supabase, etc).
• GitHub & Web (github_*, http_fetch): Source open-source reference material, read documentation, and import repositories.

Refer to the system prompt in vibn-frontend/app/api/chat/route.ts for exact rules on how the AI should behave.