# exist.io

> A self-hosted Git forge for people and coding agents.

## Docs

- [Your own Git forge](https://ravaniroshan.github.io/exist.io): An open-source, self-hosted home for repositories and coding-agent workflows.
- [Product overview](https://ravaniroshan.github.io/exist.io/overview): What exist.io is, who it is for, and the principles guiding its design.
- [Roadmap](https://ravaniroshan.github.io/exist.io/roadmap): Completed milestones and future horizons for exist.io.

## Architecture

- [Architecture](https://ravaniroshan.github.io/exist.io/architecture): The system architecture, storage layers, protocol engines, and trust boundaries of exist.io.

## Development

- [Development status](https://ravaniroshan.github.io/exist.io/development/status): Implemented capabilities, test coverage, and upcoming roadmap milestones.

## Explanation

- [Policy evaluation and merge engine](https://ravaniroshan.github.io/exist.io/explanation/merge-engine): How exist.io evaluates branch rulesets, computes 3-way merges, and determines pull request mergeability.

## Getting Started

- [Getting started](https://ravaniroshan.github.io/exist.io/getting-started): Install, bootstrap, and run your self-hosted exist.io Git forge and agent server.

## How To

- [How to authenticate and push with Git Smart-HTTP](https://ravaniroshan.github.io/exist.io/how-to/git-transport): Clone, fetch, and push code using standard Git clients and credential helpers with exist.io.
- [How to configure branch rulesets and merge protections](https://ravaniroshan.github.io/exist.io/how-to/rulesets): Protect branches, require code reviews, and enforce passing status checks using exist.io rulesets.
- [How to configure Enterprise SSO and SCIM 2.0](https://ravaniroshan.github.io/exist.io/how-to/enterprise-sso-scim): Integrate exist.io with corporate identity providers using OIDC, SAML 2.0, and RFC 7644 SCIM user sync.
- [How to configure Pure-Go SSH, Git LFS, and commit signatures](https://ravaniroshan.github.io/exist.io/how-to/ssh-git-lfs): Connect to exist.io via port 2222 SSH, track large assets with Git LFS, and verify cryptographic commit signatures.
- [How to connect AI coding agents via MCP](https://ravaniroshan.github.io/exist.io/how-to/mcp-setup): Step-by-step guide to connect Claude Desktop, Cursor, or Cline to exist.io using the Model Context Protocol.
- [How to manage exist.io with Terraform and Helm](https://ravaniroshan.github.io/exist.io/how-to/terraform-helm): Automate enterprise Git infrastructure with the official Terraform / OpenTofu provider and Kubernetes Helm chart.

## Reference

- [Command-line interface (CLI) reference](https://ravaniroshan.github.io/exist.io/reference/cli): Complete command and flag reference for the exist companion CLI.
- [Configuration and environment reference](https://ravaniroshan.github.io/exist.io/reference/configuration): Full reference for server flags, environment variables, storage layout, and enterprise protocol settings.
- [Model Context Protocol (MCP) tool catalog](https://ravaniroshan.github.io/exist.io/reference/mcp-tools): Complete technical reference of all 35 MCP tools exposed by exist.io for AI coding agents.

## Tutorials

- [Tutorial: Your first automated PR with an AI agent](https://ravaniroshan.github.io/exist.io/tutorials/first-agent): Guided hands-on lesson showing how an AI agent inspects code, creates branches, and opens pull requests on exist.io.

## Agent skills

- [exist-io](https://ravaniroshan.github.io/exist.io/.well-known/agent-skills/exist-io/SKILL.md): Read the exist.io docs instead of answering from memory. A self-hosted Git forge for people and coding agents. Use when a task involves exist.io: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://ravaniroshan.github.io/exist.io/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://ravaniroshan.github.io/exist.io/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://ravaniroshan.github.io/exist.io/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://ravaniroshan.github.io/exist.io/openapi.json.
- [Agent skills](https://ravaniroshan.github.io/exist.io/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://ravaniroshan.github.io/exist.io/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://ravaniroshan.github.io/exist.io/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://ravaniroshan.github.io/exist.io/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://ravaniroshan.github.io/exist.io/sitemap.xml): Every indexable page URL with its last-modified date.