Ambient Code Platform
March 4, 2026 ยท View on GitHub
Kubernetes-native AI automation platform for intelligent agentic sessions
Overview
The Ambient Code Platform combines Claude Code CLI with multi-agent collaboration capabilities. Teams create and manage intelligent agentic sessions through a modern web interface, backed by Kubernetes Custom Resources and operators.
Key Capabilities
- Intelligent Agentic Sessions: AI-powered automation for analysis, research, content creation, and development tasks
- Multi-Agent Workflows: Specialized AI agents model realistic software team dynamics
- Git Provider Support: Native integration with GitHub and GitLab (SaaS and self-hosted)
- Kubernetes Native: Custom Resources, Operators, and proper RBAC for enterprise deployment
- Real-time Monitoring: Live status updates and job execution tracking
Quick Start
See CONTRIBUTING.md for full local development setup with Kind.
make kind-up
# Access at http://localhost:8080
Architecture
The platform consists of containerized microservices orchestrated via Kubernetes:
| Component | Technology | Description |
|---|---|---|
| Frontend | NextJS + Shadcn | User interface for managing agentic sessions |
| Backend API | Go + Gin | REST API for managing Kubernetes Custom Resources |
| Operator | Go | Kubernetes controller that watches CRs and creates Jobs |
| Runner | Python + Claude Code CLI | Pod that executes AI with multi-agent collaboration |
User Creates Session -> Backend Creates CR -> Operator Spawns Job ->
Pod Runs Claude CLI -> Results Stored in CR -> UI Displays Progress
See docs/internal/architecture/ for detailed architecture documentation.
Documentation
- User documentation -- see the documentation site built with Astro Starlight
- Developer/architecture docs -- see docs/internal/
- Component READMEs -- each component has its own README with development instructions
Key Links
| Resource | Location |
|---|---|
| Contributing | CONTRIBUTING.md |
| Development standards | CLAUDE.md |
| Developer bookmarks | BOOKMARKS.md |
| Architecture decisions | docs/internal/adr/ |
| Testing | docs/internal/testing/ |
| Local dev setup | docs/internal/developer/local-development/ |
Components
Each component has its own detailed README:
- Frontend -- Next.js web application
- Backend -- Go REST API
- Operator -- Kubernetes controller
- Runner -- AI execution pods
- Public API -- Stateless HTTP gateway
- Manifests -- Kubernetes deployment resources
Contributing
See CONTRIBUTING.md for contribution guidelines, code standards, and local development setup.
License
This project is licensed under the MIT License -- see the LICENSE file for details.
Note: This project was formerly known as "vTeam". Technical artifacts (image names, namespaces, API groups) still use "vteam" for backward compatibility.