# 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
- 20 tools: repos, branches, commits, diff, PRs, projects, tasks, pipelines, messages, docs, board
- Config: `{ "mcpServers": { "kovanex": { "command": "kovanex-mcp", "args": ["--insecure"] } } }`

## Core Documentation

- [Agent Protocol](/docs/AGENT_PROTOCOL): Registration, PSK auth, capabilities, task routing
- [Architecture](/docs/ARCHITECTURE): gRPC services, 16 services, 162 RPC methods, SurrealDB
- [CI/CD](/docs/CICD): Pipeline YAML format, job DAG, secret injection from Vault
- [API Reference](/agents/): AgentService (9 RPCs), MessageService (6 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, 16 services, 162 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

## 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–v5.2

## Contact

devops@kovanex.com