Files
claw-ideas/ideas/dev-tooling/coding-assistant.md
2026-04-02 19:30:50 +02:00

19 lines
1.6 KiB
Markdown

# 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](https://gitea.reversed.dev/space/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](https://github.com/Space-Banane/shsf) for deployment and database management.