Stop me if you've heard this one before: you're reviewing a pull request and spot a typo. Or maybe you're triaging issues and find a simple bug that needs fixing. You leave a comment, assign the task, and... wait. What if you could just tell a bot to fix it, and moments later, a pull request appears, ready to merge?
That's the reality I wanted to create. I'm excited to introduce FixO Dev Bot, an open-source, AI-powered GitHub bot that automates the tedious parts of coding, so you can focus on what matters.
What is FixO Dev Bot?
FixO Dev Bot is your AI assistant on GitHub. Instead of manually fixing linting errors, refactoring code, or addressing minor bugs, you can simply mention @fixodev in any GitHub issue or PR comment. The bot will then:
- Understand the context: It reads the issue description, comments, and even the code itself.
- Clone your repository: It securely checks out your code into an isolated Docker container.
- Perform the work: The AI analyzes the request and makes the necessary code changes.
- Submit a pull request: It delivers the fix directly to your repository in a new PR, or updates an existing one.
Our mission is simple:
To eliminate the friction between identifying code issues and implementing solutions, making high-quality code accessible to every developer and project.
We believe that code quality shouldn't be a luxury, and developers should be free to focus on creative problem-solving, not repetitive tasks.
Why I Built This Bot
As a developer, I've spent countless hours on tasks that felt like they could be automated. Things like:
- Fixing a typo across multiple files.
- Refactoring a function to be more readable.
- Applying linter suggestions.
- Updating dependencies.
These tasks, while necessary, are a major source of context switching and a drain on productivity. I envisioned a tool that could act as a pair programmer, taking care of these small but important fixes, allowing me to stay in the flow. That's how FixO Dev Bot was born.
How it Works (The Magic Behind the Curtain)
The magic of FixO Dev Bot lies in its architecture, which is designed for security, efficiency, and intelligence.
When you mention @fixodev, a webhook is sent from GitHub to our server. The server then creates a job and adds it to a queue. A worker picks up the job and spins up a secure Docker container. Inside the container, the bot clones your repository, and an AI agent (powered by models from OpenRouter) analyzes the code and the request to generate the fix. Finally, the bot uses the simple-git library to create a branch, commit the changes, and open a pull request.
The tech stack is built for performance and reliability:
- Runtime: Bun + TypeScript
- Framework: Hono (for a lightweight server)
- Containerization: Docker
- AI Integration: OpenRouter
- Database: SQLite with Drizzle ORM
Key Features in Action
FixO Dev Bot is more than just a simple "find and replace" tool. It's designed to handle a variety of development tasks.
From Issue to PR in Minutes
Got an issue describing a bug or a small feature? Just mention the bot.
Example: In a GitHub issue
"Hey @fixodev, can you add validation to the email input field in
src/components/SignupForm.tsx? It should reject any email that doesn't include an@symbol."
A few seconds later, you'll get a pull request with the requested changes, ready for your review.
Iterative PR Improvements
The bot can also help you refine existing pull requests. If you see something that needs changing, just add a comment.
Example: In a pull request comment
"@fixodev, great start! Can you also add a unit test for this new validation logic?"
The bot will understand the context of the PR, make the requested changes, and push an update to the same branch. No new PRs, just a clean, iterative workflow.
Custom Configuration (soon)
Every project is different. With a .fixodev.yml file in your repository's root, you can customize the bot's behavior, specifying the runtime, scripts, and more.
runtime: bun:latest
scripts:
lint: bun run lint
test: bun run test
format: bun run format
autofix: true
branches:
autofix: true
target: main
How to Get Started
Ready to give it a try? It only takes a minute to set up.
- Install the GitHub App for private repositories. It'a not required for public repositories.
- (Optional) Add a
.fixodev.ymlfile to your repository for custom configuration. - Mention
@fixodevin an issue or PR comment and watch the magic happen!
Join the Community and Contribute
FixO Dev Bot is an open-source project, and we believe the best tools are built by the community. Whether you're a developer, a designer, or just someone with great ideas, we'd love for you to get involved.
Here are a few ways you can contribute:
- Beta Testers: Try the bot on your projects and give us feedback.
- Developers: Help us fix bugs, add new features, and improve performance.
- Documentation: Help us improve our guides and tutorials.
Ready to jump in? Check out the project on GitHub and join our Discord community to get started.
Conclusion
My goal with FixO Dev Bot is to build a tool that feels like a natural extension of your development workflow—an AI partner that handles the grunt work so you can focus on building amazing things.
I'm incredibly excited to see what the community builds with it. Give it a try, and let me know what you think!
Top comments (0)