chore: scaffold agent manager project

README.md

@@ -0,0 +1,31 @@
+# Agentic Gitea Issue-to-PR Manager
+
+Local, auditable CLI service that scans configured Gitea repositories for eligible issues, runs an implementer agent in an isolated workspace, opens a pull request, runs a reviewer agent, and posts a standardized human review summary.
+
+The MVP never merges pull requests.
+
+## Quick Start
+
+```bash
+uv sync
+cp config.example.yaml config.yaml
+# Put your token in .env as GITEA_TOKEN=...
+agent-gitea --config config.yaml sync-repos
+agent-gitea --config config.yaml scan-issues
+agent-gitea --config config.yaml run-once
+```
+
+`sync-repos` discovers repositories owned by the authenticated Gitea user from `/user/repos`; repositories are not listed in the config file.
+`worker` continuously syncs repositories, scans issues, and processes eligible tasks.
+
+## Commands
+
+- `agent-gitea sync-repos`
+- `agent-gitea scan-issues`
+- `agent-gitea run-once`
+- `agent-gitea worker`
+- `agent-gitea show-task <task_id>`
+- `agent-gitea retry-task <task_id>`
+- `agent-gitea cancel-task <task_id>`
+
+See `config.example.yaml` for the required configuration shape.