Vupt Documentation

Vupt runs multiple AI coding agents in parallel — each in its own git worktree — with shared context via an MCP server, a kanban-style workspace, and self-hosting as a first-class option.

This site is the canonical reference for installing Vupt, running your first Squad, configuring providers, deploying on-prem, and meeting compliance requirements.

Start here

New to Vupt? The Getting Started cluster takes you from install to first parallel agent run in under five minutes.

• Installation — desktop installers for macOS, Windows, Linux (AppImage, .deb, .rpm)
• Quick Start — five-minute walkthrough to your first Squad
• Configuration — providers (BYOK), workspace settings, telemetry opt-in
• Troubleshooting — PTY install failures, sandbox connection issues, BYOK paste errors

Core concepts

Understand the model Vupt uses to coordinate parallel agent work.

• Agents — Claude Code, Codex CLI, Cursor CLI, Aider, Cline, OpenCode, local Ollama models
• Squads — parallel execution sessions with N tasks running in isolated worktrees
• Tasks — single agent jobs within a Squad: prompt, agent, branch, hooks
• MCP server — shared context layer; stdio (local) and SSE (cloud) transports

Self-hosting

Deploy Vupt on your own infrastructure with the same product, license-keyed feature gating.

• Docker Compose — single-node deployment with Postgres + R2-compatible storage
• Helm chart — Kubernetes deployment for production at scale
• Air-gapped mode — no outbound internet, allowlist proxy, custom LLM endpoints

API and integrations

Build on top of Vupt with the cloud API and Cloud MCP transport.

• API overview — REST endpoints, authentication, rate limits, OpenAPI 3.1 spec
• Cloud MCP — SSE transport with bearer token auth for cross-team RAG

Compliance

Vupt is built for organizations with regulatory obligations.

• LGPD compliance — Brazil's data protection law; balancing tests, data residency, deletion endpoints
• Signed audit log — Ed25519-signed entries exportable to SIEM (Business tier+)

Cannot find what you need?

If a leaf page is missing or unclear, open an issue or use the Edit on GitHub link at the top of any doc page to submit a pull request directly.