https://github.com/ambient-code/platform
Vision/Mission https://ambient-code.ai : Virtual team management and collaboration platform. User guides: https://ambient-code.github.io/platform/
https://github.com/ambient-code/platform
agentic sdlc-platform speckit
Last synced: 2 months ago
JSON representation
Vision/Mission https://ambient-code.ai : Virtual team management and collaboration platform. User guides: https://ambient-code.github.io/platform/
- Host: GitHub
- URL: https://github.com/ambient-code/platform
- Owner: ambient-code
- License: mit
- Created: 2025-08-11T19:32:44.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T06:19:02.000Z (3 months ago)
- Last Synced: 2026-03-28T09:11:40.892Z (3 months ago)
- Topics: agentic, sdlc-platform, speckit
- Language: Go
- Homepage: https://ambient-code.github.io/platform/
- Size: 55.3 MB
- Stars: 93
- Watchers: 7
- Forks: 73
- Open Issues: 102
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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](CONTRIBUTING.md#local-development-setup) for full local development setup with Kind.
```bash
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/](docs/internal/architecture/) for detailed architecture documentation.
## Documentation
- **User documentation** -- see the [documentation site](docs/) built with Astro Starlight
- **Developer/architecture docs** -- see [docs/internal/](docs/internal/)
- **Component READMEs** -- each component has its own README with development instructions
### Key Links
| Resource | Location |
|----------|----------|
| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
| Development standards | [CLAUDE.md](CLAUDE.md) |
| Developer bookmarks | [BOOKMARKS.md](BOOKMARKS.md) |
| Architecture decisions | [docs/internal/adr/](docs/internal/adr/) |
| Testing | [docs/internal/testing/](docs/internal/testing/) |
| Local dev setup | [docs/internal/developer/local-development/](docs/internal/developer/local-development/) |
## Components
Each component has its own detailed README:
- [Frontend](components/frontend/) -- Next.js web application
- [Backend](components/backend/) -- Go REST API
- [Operator](components/operator/) -- Kubernetes controller
- [Runner](components/runners/ambient-runner/) -- AI execution pods
- [Public API](components/public-api/) -- Stateless HTTP gateway
- [Manifests](components/manifests/) -- Kubernetes deployment resources
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines, code standards, and local development setup.
## License
This project is licensed under the MIT License -- see the [LICENSE](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.