Frank Schwenk
239e110b72
Playground repos can push directly to the default branch instead of opening PRs; agent runtime is configurable (default 5m). Co-authored-by: Cursor <cursoragent@cursor.com>
58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
# SOUL.md — cursor-gitea-agent
|
|
|
|
## Agent Quick Start
|
|
|
|
- **What:** Gitea composite Action — `@cursor` in issue/PR comments runs Cursor CLI + gitea-mcp on the Actions runner.
|
|
- **Gitea:** https://gitea.schwenk.online — repo `froxxxy/cursor-gitea-agent`
|
|
- **Default model:** `composer-2.5` (override via `ai_model` input only when Fränky asks)
|
|
- **Runner:** Gitea Actions on `boka`
|
|
- **Commit policy:** no commit unless Fränky explicitly asks
|
|
|
|
## Product Name
|
|
|
|
cursor-gitea-agent
|
|
|
|
## One-Liner
|
|
|
|
Gitea Action that triggers Cursor AI when `@cursor` is mentioned in issue or PR comments.
|
|
|
|
## Vision
|
|
|
|
Bring Cursor-style agent help into self-hosted Gitea — without GitHub, without leaving the forge. Forked from [flow96/cursor-gitea-agent](https://github.com/flow96/cursor-gitea-agent) and hardened for schwenk.online.
|
|
|
|
## Audience
|
|
|
|
Fränky and repos on gitea.schwenk.online where the `cursor` bot user is a collaborator.
|
|
|
|
## Tone & Wording
|
|
|
|
- **Voice:** direct, technical, no hype
|
|
- **Formality:** du (chat), English for scripts and action logs
|
|
- **Error messages:** say what failed and what to check next
|
|
- **Forbidden:** LinkedIn slop, fake certainty
|
|
|
|
## Non-Goals
|
|
|
|
- Not a general-purpose Gitea bot framework
|
|
- Not auto-deploy or CI for arbitrary repos without explicit setup
|
|
- Not a replacement for local Cursor IDE sessions
|
|
- No tracking, no phone-home beyond Cursor API and your Gitea instance
|
|
|
|
## Infrastructure (project-local)
|
|
|
|
- **Gitea:** https://gitea.schwenk.online
|
|
- **Action reference:** `https://gitea.schwenk.online/froxxxy/cursor-gitea-agent@main`
|
|
- **Bot user:** `cursor` (required name for mention trigger and loop guard)
|
|
- **Runner:** ubuntu-latest on boka Gitea Actions
|
|
- **MCP binary:** gitea-mcp v1.3.0, cached at `/tmp/gitea-mcp/gitea-mcp` on the runner
|
|
|
|
## Project-Specific Rules
|
|
|
|
- Default AI model stays `composer-2.5` until Fränky changes it manually — do not chase README model lists.
|
|
- Skip LICENSE and test suite unless explicitly requested.
|
|
- Parse event context from `GITHUB_EVENT_PATH` with `jq` — do not rely on undocumented `gitea.event.*` template fields in shell scripts.
|
|
- Install Cursor CLI and gitea-mcp only when `@cursor` fires and only if not already present on the runner.
|
|
- Gitea secret names cannot start with `GITEA_` or `GITHUB_` — use `CURSOR_BOT_TOKEN` for the bot token, not `GITEA_TOKEN`.
|
|
- `push_to_default_branch` (`"true"` / `"false"`, default `"false"`): playground repos may push directly to the default branch; production repos keep PR-only behavior.
|
|
- `agent_timeout` (default `5m`): caps Cursor agent runtime via `timeout`; raise for long tasks (e.g. `30m`).
|