commit 7e4c4b2ed5edeccd1a797da5e0d07a2e1e47c474
Author: oval <ole@covalente.dk>
Date:   Tue Jul 7 15:11:15 2026 +0000

    docs: initial integration guide

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2a2ac9d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# Goose + Gitea Integration Guide
+
+Complete guide for integrating the Goose AI agent with a self-hosted Gitea instance using the official Gitea MCP Server.
+
+## 📚 Wiki
+
+The full guide is in the [wiki](https://gt.covalente.dk/oval/goose-gitea-guide/wiki):
+
+- [Home](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/Home)
+- [Installation](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/Installation)
+- [Configuration](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/Configuration)
+- [SSH Setup](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/SSH-Setup)
+- [Usage](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/Usage)
+- [Troubleshooting](https://gt.covalente.dk/oval/goose-gitea-guide/wiki/Troubleshooting)
+
+## 🔜 Quick Start
+
+```bash
+curl -sL "https://gitea.com/gitea/gitea-mcp/releases/download/v1.3.0/gitea-mcp_Darwin_arm64.tar.gz" -O gitea-mcp.tar.gz
+tar xzf gitea-mcp.tar.gz
+cp gitea-mcp /opt/homebrew/bin/gitea-mcp
+chmod +x /opt/homebrew/bin/gitea-mcp
+gitea-mcp -v  # should output: 1.3.0
+```
+
+## 🩇 Links
+
+- Goose: https://github.com/AAIF/goose
+- Gitea MCP Server: https://gitea.com/gitea/gitea-mcp
+- This Gitea instance: https://gt.covalente.dk
\ No newline at end of file