cursor_hackathon

Backend-only CLI that:

1. Takes a GitHub repo URL
2. Finds an issue
3. Attempts an automated code fix
4. Commits changes and opens a PR

Requirements

• Python 3.10+
• git
• gh (GitHub CLI), authenticated (gh auth login)
• OPENAI_API_KEY in .env or exported in shell
• Optional: AUTOFIX_GH_BIN if GitHub CLI is installed under a different command/path

Setup

python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

Then edit .env and set OPENAI_API_KEY.

Usage

autofix doctor
autofix run https://github.com/owner/repo --no-create-pr
autofix doctor-patch --repo-dir .autofix-workspace/repo-name
autofix run https://github.com/owner/repo

doctor-patch creates a synthetic probe commit and PR by default. Use --no-create-pr if you only want a local apply/revert patch check.

Optional flags:

• --issue 123 pick a specific issue
• --workspace .autofix-workspace clone location
• --no-create-pr run fix + commit only
• --no-fallback-synthetic-pr disable synthetic PR fallback when issue-fix generation fails

Notes

• The default behavior selects the first open issue from gh issue list.
• Patch generation is done through OpenAI and applied as a git diff.
• Validation is best-effort and auto-detects simple test commands.
• Docker is optional. Use it only if you want environment isolation/reproducibility.