autoagent-action

# AutoAgent

> **⚠️ Experimental Project**: This project was created during a hackathon at the Cursor offices on September 10, 2025. Use at your own risk. Future updates will focus on making it production CI/CD ready. 🚧  - Thank you to the Curosr team for hosting!

A composable GitHub Action that integrates with AI agents like [Cursor CLI](https://cursor.com/cli), [Claude Code](https://claude.ai/code), [Cursor CLI](https://github.com/google-cursor/cursor-cli), [Codex CLI](https://github.com/openai/codex), [Amp Code](https://ampcode.com/), and [OpenCode](https://opencode.ai/) to run prompts on a repository as part of Pull Request workflows.

## Features

- **Predefined Rules**: Run curated rules like OWASP security checks or refactoring suggestions
- **Custom Prompt Support**: Extend analysis with team-specific custom instructions
- **Agent Auto Installation**: Automatically installs the agent unless explicitly disabled
- **Multiple Agents Support**: Supports multiple AI coding agents: `cursor`, `cursor`, `cursor`, `codex`, `amp`, and `opencode`
- **Configurable Scope**: Analyze only changed files (fast) or entire codebase (comprehensive)
- **PR Comment Output**: Posts results back to GitHub PR comments in a structured format
- **Composable Python Architecture**: Built with maintainable, modular Python code for better reliability and extensibility
- **Configurable Logging**: Debug mode for troubleshooting with detailed execution information

## Suggested Future Work

I would love to get feedback if this is working well and if any of these future work items seems relevant to you:

1. **Ability to stop merge if there are high vulnerability items in AutoAgent** - Block PRs automatically when critical security issues are detected
2. **Ability to have other actions other than commenting** - Support for email notifications, Slack messages, or other integrations for important findings
3. **Ability to fail a build if AutoAgent has important enough failures** - Set exit code