Devtoolwatch Boardmini-SWE-agent review
mini-SWE-agent is a minimal Python AI agent, about 100 lines for its agent class, that solves GitHub issues or helps in your command line.
TL;DR
mini-SWE-agent is a minimal AI software engineering agent from the team behind SWE-bench and SWE-agent. It is for developers who want a simple command line agent and for researchers running benchmarks, fine-tuning or RL. Its only tool is bash, it keeps a linear history, and it runs each action independently.
- 9kGitHub stars
- +196new stars, week of Oct 25
- 3.6Mdownloads a week, −3% vs 4-week avg
- #79in Coding agents this week
mini-SWE-agent at a glance
- Category
- Coding agents
- Maintained by
- SWE-agent (organization, @SWE-agent on GitHub)
- License
- MIT
- Language
- Python
- Repository
- github.com/SWE-agent/mini-swe-agent
- Website
- mini-swe-agent.com
- PyPI package
- mini-swe-agent 2.4.6
- Latest release
- v2.4.6 on GitHub, Jul 23, 2026
- First published
- Jun 28, 2025
What mini-SWE-agent does
- mini-SWE-agent solves GitHub issues or helps you with tasks in your command line.
- mini-SWE-agent uses bash as its only tool and does not need the tool-calling interface of language models.
- mini-SWE-agent runs in local environments, docker/podman, singularity/apptainer, bubblewrap, contree and more.
- mini-SWE-agent supports models via litellm, openrouter and portkey, including /completion and /response endpoints.
- mini-SWE-agent includes a trajectory browser, batch inference and Python bindings.
- mini-SWE-agent keeps a linear message history, so the trajectory equals what the model is prompted with.
How it works
mini-SWE-agent runs as the mini CLI or through Python bindings, such as a DefaultAgent with a LitellmModel and LocalEnvironment. Each step appends to a linear message history. The model issues bash commands, which run with subprocess.run as independent actions instead of a stateful shell session. That design lets you swap in docker exec to run actions in sandboxes.
How to install and start using mini-SWE-agent
Try the CLI with uv
pip install uv && uvx mini-swe-agentWith pip
pip install mini-swe-agentRequirements
- Python 3.10 or newer
- Access to a language model through litellm, openrouter, portkey or a similar provider
First steps
- Install the package with pip install mini-swe-agent.
- Run the CLI with the mini command.
- Read the quick start guide and the global configuration docs to set up models and settings.
Who mini-SWE-agent is for
- Developers who want a quick command line agent that works locally
- Researchers running sandboxed benchmark evaluations such as SWE-bench
- Teams doing fine-tuning or RL who want to avoid overfitting to one agent scaffold
- Developers who want a hackable agent with very simple control flow
Limitations to know
- mini-SWE-agent has no tools other than bash, so specific tasks rely on the model using the shell.
- mini-SWE-agent does not keep a stateful shell session; every action runs independently.
- For experimenting with custom tool sets or history processors, the README recommends SWE-agent instead.
- mini-SWE-agent v2 changed from v1; v1 users should read the migration guide.
Is mini-SWE-agent growing? Usage data
In the week of Oct 25–31, 2026, mini-SWE-agent ranked #236 on the Devtoolwatch Board and #79 in Coding agents, with a momentum score of 39 out of 100. Its main package had 3.6M downloads that week, −3% against its own 4-week average.
Show the weekly numbers
| Week of | New stars |
|---|---|
| Aug 9, 2026 | 212 |
| Aug 16, 2026 | 165 |
| Aug 23, 2026 | 163 |
| Aug 30, 2026 | 131 |
| Sep 6, 2026 | 492 |
| Sep 13, 2026 | 331 |
| Sep 20, 2026 | 207 |
| Sep 27, 2026 | 189 |
| Oct 4, 2026 | 194 |
| Oct 11, 2026 | 236 |
| Oct 18, 2026 | 210 |
| Oct 25, 2026 | 196 |
On Hacker News
- Show HN: Mini-swe-agent achieves 65% on SWE-bench in 100 lines of python, 7 points and 4 comments (Jul 25, 2025)
The Board ranks tools by four signals each week: new stars, new stars for the repo's size, added downloads and download growth beyond the market. How the ranking works.
mini-SWE-agent alternatives
Other AI coding agents on the Board in the week of Oct 25–31, 2026, by momentum:
| Rank | Tool | Stars | Downloads/wk |
|---|---|---|---|
| #1 | CindyCindy is an open-source AI agent app for desktop and mobile that combines Claude Code, Codex and Pi across your connected devices. | 8.8k | – |
| #2 | OpenMausBotOpenMausBot is an open-source desktop chat app where each contact is a local Claude, Codex, or Grok CLI agent with its own computer. | 9.6k | – |
| #3 | OrcaOrca is a desktop agent development environment for running Claude Code, Codex, and other CLI coding agents in parallel, each in its own… | 111.7k | – |
| #4 | OpenBotOpenBot is an open-source, self-hosted template for AI coworkers that each get their own browser, files and granted tools, with every… | 9.1k | – |
| #5 | Agent ReachAgent Reach is a Python CLI that lets AI agents search and read platforms such as Twitter, Reddit, YouTube, GitHub, Bilibili and… | 107.2k | – |
| #6 | Skill RecorderSkill Recorder is a desktop app that records your on-screen work session and turns it into a reusable agent Skill or Automation. | 5.6k | – |
Recent mini-SWE-agent releases
mini-SWE-agent FAQ
Is mini-SWE-agent free and open source?
Yes. mini-SWE-agent's source code is on GitHub (SWE-agent/mini-swe-agent) under the MIT license, so you can use it for free.
How do I install mini-SWE-agent?
Run pip install uv && uvx mini-swe-agent. The mini-swe-agent package needs Python 3.10 or newer. The install section above has the other options from the project's README.
Is mini-SWE-agent still maintained?
Yes. The SWE-agent/mini-swe-agent repository was last updated on Oct 19, 2026, and the latest release, v2.4.6 on GitHub, came out on Jul 23, 2026.
How popular is mini-SWE-agent?
mini-SWE-agent has 9k GitHub stars as of Nov 1, 2026. It gained 196 new stars in the week of Oct 25–31, 2026, against a 12-week average of 227 a week. Its main package had 3.6M downloads that week, −3% against its own 4-week average. That made it #79 among AI coding agents on the Devtoolwatch Board.
mini-SWE-agent vs Claude Code: how do they compare?
mini-SWE-agent and Claude Code are both tracked by Devtoolwatch as AI coding agents. mini-SWE-agent has 9k GitHub stars and Claude Code has 154.1k. In the week of Oct 25–31, 2026, mini-SWE-agent's main package had 3.6M downloads and Claude Code's had 11.6M. Claude Code is Anthropic's agentic coding tool that reads your codebase, edits files, runs commands, and handles git workflows through natural language. Claude Code review.
What are the best alternatives to mini-SWE-agent?
Other AI coding agents on the Devtoolwatch Board in the week of Oct 25–31, 2026, by momentum: Cindy (#1), OpenMausBot (#2), Orca (#3), OpenBot (#4), Agent Reach (#5). The alternatives table above has their numbers.
How does mini-SWE-agent compare to Claude Code?
mini-SWE-agent's README says it starts much faster than Claude Code. It also links a DeepSWE evaluation reporting that mini-SWE-agent beats Claude Code and Codex on that benchmark.
Which models does mini-SWE-agent work with?
mini-SWE-agent supports all models via litellm, openrouter, portkey and more. Because it uses only bash and not the tool-calling interface, the README says it can run with any model.
Should I use SWE-agent or mini-SWE-agent?
The README recommends mini-SWE-agent as the default choice. It suggests SWE-agent only if you want to experiment with different tool sets or history processors.
Can mini-SWE-agent run in sandboxes?
Yes. mini-SWE-agent supports docker/podman, singularity/apptainer, bubblewrap and contree. Actions run through subprocess.run, which can be swapped for docker exec.
Can I use mini-SWE-agent from Python code?
Yes. mini-SWE-agent has Python bindings. You build a DefaultAgent with a model such as LitellmModel and an environment such as LocalEnvironment, then call agent.run with a task.
Sources
- SWE-agent/mini-swe-agent on GitHub
- mini-SWE-agent README
- mini-swe-agent on PyPI
- mini-SWE-agent website
- Release v2.4.6 (Jul 23, 2026)
- Release v2.4.5 (Jul 6, 2026)
- Release v2.4.4 (Jul 2, 2026)
- Hacker News: Show HN: Mini-swe-agent achieves 65% on SWE-bench in 100 lines of python
- Devtoolwatch Board, the week of Oct 25–31, 2026
mini-SWE-agent README badge
Maintainers can show the tool's weekly Board rank in their README:
[](https://index.devtoolwatch.com/tools/mini-swe-agent/)How this page is made: Devtoolwatch writes each review from the project's README, releases, package metadata and website, with an AI model, then checks every claim against the source it cites and drops what the sources don't support. The numbers come from Devtoolwatch's daily GitHub snapshots, GitHub's stargazer history, and the npm and PyPI download APIs. Spotted an error? Email [email protected].