Sweep — Turn GitHub Issues into Pull Requests

What it is

Sweep is an AI-powered GitHub bot that reads issue descriptions and generates pull requests with the corresponding code changes. You write an issue describing a bug or a small feature, tag Sweep, and it analyzes your codebase, generates a fix, and opens a PR for review.

The project originally ran as a hosted service. The Sweep team has since pivoted to building a JetBrains AI coding assistant plugin, but the codebase remains available as an open-source reference for building AI code generation agents.

How it saves time or tokens

For routine bug fixes and small feature additions, the cycle of reading code, writing a fix, and opening a PR can take 30 minutes or more. Sweep reduces this to the time it takes to write an issue description. The estimated token cost is approximately 496 tokens per workflow.

Sweep also demonstrates a pattern for AI agent design: it scans the full repository for context, plans changes across multiple files, and handles the git workflow (branch, commit, PR) automatically.

How to use

1. The hosted Sweep bot is no longer actively maintained. To use Sweep, run it locally or study the codebase:

git clone https://github.com/sweepai/sweep.git
cd sweep
pip install -r requirements.txt

1. Configure your GitHub token and OpenAI API key in the environment.

1. Run the agent against a repository:

export GITHUB_TOKEN=ghp_...
export OPENAI_API_KEY=sk-...
python -m sweepai.app

Example

# GitHub Issue (tagged for Sweep)

Title: Fix broken pagination on /api/users endpoint

Body:
The /api/users endpoint returns all users instead of
respecting the `page` and `limit` query parameters.
The SQL query in `src/routes/users.ts` is missing
OFFSET and LIMIT clauses.

# Sweep generates a PR:
# - Modifies src/routes/users.ts to add OFFSET/LIMIT
# - Updates the test file to cover pagination
# - Opens PR with description explaining the changes

Related on TokRepo

• AI Tools for Coding -- Other AI coding assistants and agents
• AI Tools for Automation -- Workflow automation tools for development teams

Common pitfalls

• The hosted Sweep bot is no longer actively maintained. Expect to run and modify the codebase yourself if you want to use it.
• Sweep works best for small, well-described issues. Complex multi-file refactors or architectural changes are beyond its current capability.
• Generated PRs still need human review. Sweep can introduce subtle bugs, especially in code with complex business logic or edge cases.