Ambient Code Platform

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.