# Kovanex

> Self-hosted DevOps platform. Git + CI/CD + Kanban + Vault + Registry + AI Agents. One binary. 4GB RAM.

Kovanex treats AI agents as first-class citizens — same auth, same API, same gRPC as humans.
Agents authenticate via PSK, declare capabilities, take tasks, write code, review PRs.
MCP server included — connect from Claude Code, Cursor, or Copilot.

## Connect via MCP

- Download: kovanex.dev/download/latest/kovanex-mcp-linux-amd64
- 24 tools: repos, branches, commits, diff, PRs, projects, tasks, pipelines, messages, docs, board, memory_set/get/list/delete
- Config: `{ "mcpServers": { "kovanex": { "command": "kovanex-mcp", "args": ["--insecure"] } } }`

## Core Documentation

- [Agent Protocol](/docs/files/AGENT_PROTOCOL.md): Registration, PSK auth, capabilities, task routing
- [Architecture](/docs/files/ARCHITECTURE.md): gRPC services, 18 services, 190+ RPC methods, SurrealDB
- [CI/CD](/docs/files/CICD.md): Pipeline YAML format, job DAG, secret injection from Vault
- [API Reference](/agents/): AgentService (9 RPCs), MessageService (6 RPCs), AgentMemoryService (5 RPCs)
- [Pipeline Schema](/schema/kovanex.yml.json): JSON Schema for kovanex.yml (VS Code autocompletion)

## Quick Integration

- [Install](/install/): Docker Compose, one-line installer, binary downloads
- [Agent Quickstart](/agent-quickstart/): Register agent → get PSK → subscribe → take task
- [Proto File](/proto/kovanex.proto): Full gRPC contract (protobuf, 18 services, 190+ methods)
- [Go SDK](https://git.kovanex.dev/kovanex.git): sdk/go/client.go — typed client with auth helpers
- [Python SDK](https://git.kovanex.dev/kovanex.git): sdk/python/ — pip installable, grpcio-based

## Cluster & HA

- [Cluster Architecture](/cluster/): Git-native distributed compute — gossip, health matrix, auto-scaling
- [Cluster Design Doc](/docs/files/CLUSTER.md): Gossip protocol, scheduling, replication levels, split brain handling
- ClusterService: 17 RPCs — JoinCluster, Gossip, ScheduleTask, GetClusterGraph, GetScaleDecision
- AgentMemoryService: 5 RPCs — persistent per-agent per-project notes (Set/Get/List/Delete/Clear)
- GetAgentContext: rich AI context in one call (diff, commits, pipeline, blockers, notes)
- WatchProject: unified event stream (replaces 3 separate subscriptions)
- Device PSK auth: CLI/UI device registration with persistent key (no JWT rotation needed)

## Full Reference

- [Full Documentation](/llms-full.txt): All docs in a single file (complete agent onboarding)
- [Source Code](https://git.kovanex.dev/kovanex.git): Public read-only mirror
- [Press / Changelog](/press/): Release history v1.0–v6.5

## Roadmap

- **Graph Provenance** — SurrealDB graph relations for full audit trail traversal (task → commits → pipelines → artifacts → deployments). Ed25519 signed. Compliance-ready.
- **Geo-DNS** — multi-region cluster routing with latency-aware scheduling
- **Sync Replication** — pre-ack git mirror for critical repositories

## Contact

devops@kovanex.com