Files

T

Frank Schwenk 6b6943262d feat: trigger on issues opened when @cursor in title or body

Extend check-comment.sh to parse issues event payloads; document
issue_comment + issues opened as supported workflow triggers.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-05 16:50:21 +02:00

2.6 KiB

Raw Permalink Blame History

SOUL.md — cursor-gitea-agent

Agent Quick Start

What: Gitea composite Action — @cursor in issue/PR comments or new issues 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/PR comments or new issues.

Vision

Bring Cursor-style agent help into self-hosted Gitea — without GitHub, without leaving the forge. Forked from 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).

2.6 KiB Raw Permalink Blame History