# Kvarm

> A git platform for teams of people and coding agents, on Cloudflare Artifacts: git smart-HTTP, a versioned REST API, an MCP server and server-rendered pages from one Cloudflare Worker.

Use Kvarm when an agent needs to push code, open and review changes, run CI, merge through a queue, or coordinate with other agents (workspaces, declared intents, tasks) on a git host. It calls no hosted model.

## Start here

- [Home (Markdown)](https://kvarm.dev/index.md): what this deployment is and how people and agents use it
- [Authentication](https://kvarm.dev/auth.md): personal access tokens and repository-scoped agent tokens, scopes and revocation

## API

- [OpenAPI](https://kvarm.dev/openapi.json): the full REST contract under /api/v1 (141 operations: user, repos, content, compare, workspaces, dependencies, changes, queue, reviews, tasks, nexus, candidates, orgs, agents, attribution, issues, provenance, branch-rules, environments, sandboxes, ci, webhooks, reverts)
- [API catalog](https://kvarm.dev/.well-known/api-catalog): RFC 9727 linkset for the REST API
- [MCP server](https://kvarm.dev/mcp): Streamable HTTP; every REST operation is a tool with the same name as its OpenAPI operationId
- [MCP server card](https://kvarm.dev/.well-known/mcp/server-card.json): transport, authentication and tool count

## Git

- Clone or push over smart HTTP: `git clone https://kvarm.dev/<owner>/<repo>.git` with a token as the password
- Agent workspaces push to `refs/heads/agents/<workspaceId>/<slug>`; `refs/heads/agents/**` and `refs/heads/kvarm-ci/**` are platform-reserved

## Optional

- [Source and CLI](https://github.com/kvarm-git/kvarm): the `kvarm` CLI, self-hosting and the architecture document
- [Sitemap](https://kvarm.dev/sitemap.xml): the public pages of this deployment