claw-ideas/ideas/dev-tooling/coding-assistant.md

Coding Assistant Agent

An agent that takes assigned tasks from Gitea and implements them within the repository.

Overview

A tightly integrated coding companion that interfaces with assign-me-openclaw. This project uses the SHSF (Serverless High-Speed Functions) runner to handle Gitea webhooks and notify an AI agent via the OpenClaw API when it is assigned to an issue or pull request.

Features

• Gitea Webhook Integration: Uses assign-me-openclaw to listen for assigned and unassigned events from Gitea.
• Stateful Assignment Tracking: Employs a database (via SHSF's _db_com.py) to track assignees across events, ensuring the agent is correctly notified even when payload data is sparse.
• OpenClaw Notification: Automatically sends formatted Markdown notifications to the OpenClaw API when the configured AGENT_USERNAME is assigned.
• SHSF Deployment: Designed to run as a serverless function, making it lightweight and highly reactive.
• Automated Workflow: Once notified, the agent can be programmed to clone the repository, create a branch, and implement changes based on the Gitea issue description.
• Task Assignment Logic: Identifies specific triggers (like labels or comments) to initiate coding tasks.

Technical Details

• Environment Driven: Configurable via OPENCLAW_URL, OPENCLAW_TOKEN, and AGENT_USERNAME.
• Primary Logic: Driven by main.py, which processes incoming POST requests and filters relevant Gitea events.
• Integration Point: Works seamlessly with SHSF for deployment and database management.