# Reason Agent Reason Agent is the autonomous software engineer built by [Reason Machines](https://reasonmachines.com). Connect a GitHub repository, hand it work, and Reason's cloud agents open evidence-backed pull requests with screen recordings, logs and review-ready diffs. This repository is the public home for Reason Agent: how to use it, its release history and its published benchmark results. The product itself runs at [reasonmachines.com](https://reasonmachines.com). [Website](https://reasonmachines.com) · [Docs](https://docs.reasonmachines.com) · [Blog](https://reasonmachines.com/blog) · [Benchmarks](benchmarks/) · [llms.txt](https://reasonmachines.com/llms.txt) ## Use Reason ### Web app 1. Sign in at [reasonmachines.com](https://reasonmachines.com). 2. Connect GitHub and choose the repositories Reason may work in. 3. Describe a task or assign an issue. Reason works in an isolated cloud environment, reproduces and tests its change, and returns a pull request with the evidence attached. 4. Review, ask for changes in the same session, and merge. Sessions stay attached to their messages and results, so you can pick one up again on the web, on iOS or in Reason for macOS, which can also let a session use your local checkout, tools and development ports. ### Slack Connect Slack from the web app. Then: - mention Reason in a channel to start a task from the conversation; - message Reason directly for a private task; - reply in the thread to steer a running task. Shared Slack channels work too: people from the other workspace link to their own Reason account before Reason acts for them. ### Terminal ```sh curl -fsSL https://reasonmachines.com/install.sh | bash reason ``` Commands and options: [reason-machines/reason-cli](https://github.com/reason-machines/reason-cli). ### From other coding agents Use Reason from Claude Code, Codex and other MCP clients with the Reason plugins: [reason-machines/reason-plugins](https://github.com/reason-machines/reason-plugins). ### Connectors The tools and services Reason can connect to (issue trackers, observability, databases, docs and more) are listed in [reason-machines/reason-marketplace](https://github.com/reason-machines/reason-marketplace). ### API Programmatic per-user access is available through the HTTP API at `https://api.reasonmachines.com` with a `reason_` API key from Settings → API. Reference: [docs.reasonmachines.com](https://docs.reasonmachines.com) and the [OpenAPI document](https://api.reasonmachines.com/v3/openapi.json). ## Releases Reason Agent versions are `X.Y`. One version covers everything server-side (agent, web, API and Slack), so every client you connect from shows the same version. A daily release train advances `Y`; `X` changes only by decision. | Version | Date | Notes | |---|---|---| | 1.0 | September 14, 2026 | First public results: DeepSWE v1.1. [Post](https://reasonmachines.com/blog/reason-agent-deepswe) · [results](benchmarks/deepswe-v1.1/) | Later versions are added here as their results are published. ## Benchmarks | Benchmark | Version | Model · effort | Reason Agent | Published | Details | |---|---|---|---|---|---| | DeepSWE v1.1 (113 tasks) | 1.0 | GPT-6 Astra · xhigh | 73.0% (165/226), median 13.8 min | September 14, 2026 | [deepswe-v1.1](benchmarks/deepswe-v1.1/) | Each benchmark folder holds a write-up with methodology and caveats, a summary CSV and the full results JSON exactly as published on reasonmachines.com. ## License Documentation and data in this repository are released under the [MIT License](LICENSE). The Reason product is not open source.