A desktop app for macOS & Windows · Free and open source
Know what a repo needs before you run it.
Paste a public GitHub or GitLab link. Reporun reads the project's manifest files, compares them with what's installed on your computer, and gives you a plain list of what's missing — with the exact commands to fix it, shown to you before anything runs.
Free preview · macOS 0.1.1 (Apple silicon & Intel) · Windows 0.1.2 (x64)
Reporun showing a sample check of acme/studio: Git and Node.js compatible, pnpm and Docker not installed, Python version mismatch, and an install plan for Python waiting for confirmation.
01 The problem
"Just run npm install."
Most READMEs assume your computer is set up like the author's. When it isn't, you find out one error at a time: the wrong package manager, a runtime that's too new, a tool you never installed.
Each fix takes a search, and each search turns up the next problem. In the example on the right, it takes four commands to discover three issues — and nothing works yet.
02 How it works
Four steps, in this order.
You approve the last one.
-
01
Paste a link
Any public repository on github.com or gitlab.com. Reporun checks the current default branch and pins the result to that exact commit, so the check and the download always match.
https://github.com/acme/studio→ pinned toa1b2c3d -
02
Read the manifests
It fetches only the files that describe requirements —
package.json,pyproject.toml,Cargo.toml,go.mod, Dockerfiles and so on. Nothing is cloned at this point.Up to 35 files · 5 folders deep · 150 KB each -
03
Compare with your computer
Installed versions are checked against the ranges the project declares. Anything missing, too old or too new is listed with the file it came from and a short explanation.
Python 3.13.2needs>=3.10 <3.13→ mismatch -
04
Review, then run
Every install, download and launch is shown as the exact command first. Output streams live, you can stop a job at any time, and an unused plan expires after five minutes.
brew install python@3.10waiting for you
03 What it reads
Eight languages, plus Docker
and environment files.
The full list. If a file or version format isn't supported, Reporun says so in the report instead of guessing.
| Ecosystem | Files it reads | What it can set up or launch |
|---|---|---|
| JavaScript / TypeScript | package.json (engines, packageManager), Volta, .nvmrc, .node-version, lockfile names | npm, pnpm, Yarn or Bun install; any script in package.json |
| Python | pyproject.toml, requirements.txt, .python-version, Pipfile | uv, Poetry, or an isolated .venv with pip; launch follows the README |
| Rust | Cargo.toml, rust-toolchain.toml | cargo fetch, cargo run |
| Go | go.mod | go mod download, go run . |
| Java | pom.xml, build.gradle(.kts) | Maven dependencies or Gradle build; launch follows the README |
| Ruby | Gemfile, .ruby-version | bundle install; launch follows the README |
| PHP | composer.json | composer install; launch follows the README |
| .NET | global.json, .csproj | dotnet restore, dotnet run |
| Containers | Dockerfile, Compose service names | Checks the Docker CLI and daemon; you start containers yourself |
| Environment | .tool-versions, .env.example, .env.sample | Variable names only — never values |
Missing tools are installed through Homebrew on macOS or winget on Windows, from a curated list. Package-manager versions are installed with npm, with lifecycle scripts turned off.
04 Who it's for
Anyone setting up
code they didn't write.
Students and new developers
Get a course or tutorial repo running without a day lost to setup.
Developers trying a tool
See what a project will change on your computer before you clone it.
Maintainers and teachers
See your project the way a fresh computer sees it, and catch setup gaps before your users do.
Teams onboarding people
New laptop, new hire, old service. Compare what the repo expects with what's installed.
05 Safety
It reads first,
and asks before it runs.
Reporun was built around one rule: you should see every command before it touches your computer.
- GitHub token optionalChecks use public APIs by default. A read-only GitHub token raises your rate limit; it's validated, encrypted on your computer, sent only to GitHub's API and never synced.
- Plans run once, then expireCommands are prepared by the app itself, tied to your session, and expire after five minutes. The interface can't submit its own commands.
- Careful downloadsRepositories are fetched over HTTPS with inherited Git hooks and config turned off. Git LFS files and submodules aren't fetched automatically.
- No install scriptsPackage managers installed through npm use
--ignore-scripts. - Secrets stay localSign-in tokens use your operating system's secure storage. Environment values, local paths and logs are never uploaded.
06 Limits
What it won't do
(at least not yet).
- Check private repositories. Public github.com and gitlab.com only, using the default branch. Adding a GitHub token doesn't change that.
- Promise a project will run. It reads manifests. It can't check credentials, external services or setup steps that only live in someone's head.
- Install anything on its own. Every change waits for your click.
- Take keyboard input in running jobs. Commands that ask questions mid-run aren't supported yet.
- Always win the PATH. An older runtime earlier on your PATH can still take priority. Reporun rechecks after installing so you'll know.
- Run on Linux or Windows on ARM. This preview ships for Macs (Apple silicon and Intel) and Windows x64.
07 Build status
Where things stand.
New since the last update
- Signed, notarized Mac installers, now for Intel too. Both Mac builds are signed with an Apple Developer ID and notarized by Apple, so macOS opens them normally. The app inside is the same 0.1.1.
- Sign-in is open to everyone. Google sign-in is no longer limited to test accounts; any Google account can sign in and check repositories.
- Windows 0.1.2 fixes the icon. The app, installer and uninstaller now carry the Reporun icon, so desktop and Start menu shortcuts stop showing Electron's default. Every build now checks the packaged icon and architecture so it can't slip back.
Tested
- 59 engine tests and 6 interface tests pass, and the production build succeeds
- Both Mac installers pass Apple's checks: Developer ID signature, notarization ticket and Gatekeeper
- On an Apple silicon Mac: the app launches, Google sign-in works, history syncs, and both survive a restart
- The rate-limit countdown worked against a real GitHub limit in the packaged Mac app
- A Windows user installed and ran the previous Windows build (0.1.1)
- The icons inside the Windows 0.1.2 app and installer match the source icon file
- SHA-256 checksums published for every installer
Release notes and checksums: Mac 0.1.1 · Windows 0.1.2 · Full changelog
08 Download
Get Reporun.
Pick your platform below.
macOS Your system
Apple silicon & Intel · .dmg
Windows Your system
x64 · .exe installer
This is a development preview. The Mac installers are signed and notarized by Apple, so macOS only asks its usual first-open question. The Windows installer isn't code-signed yet, so Windows may show a SmartScreen warning; compare the file's SHA-256 checksum with the release notes if you want to be sure it's ours. Windows ARM64 and Linux builds aren't available yet. You don't need Node.js or anything else installed to open the app. Release notes and checksums: Mac · Windows
09 FAQ
Questions people ask.
Is it free?
Yes. Reporun is free and open source under the MIT license.
Do I need Node.js or other tools installed first?
No. The app runs on its own. It tells you which tools a particular repository needs, and can install them through Homebrew (macOS) or winget (Windows) if you have those.
Which repositories can it check?
Public repositories on github.com and gitlab.com, on their default branch. Private repositories aren't supported, even with a token.
Will it install or run anything without asking?
No. Every action is shown as a command preview first. A plan can only run once and expires after five minutes.
Do I have to sign in?
Yes, to check repositories. Sign-in is with Google (any Google account works) and keeps your 100 most recent checks across devices. Without signing in you can still explore the sample report and see what's installed on your computer. What syncs: repository details, the requirements found, the relevant installed versions, and your OS name and architecture. Full tool lists, local paths, environment values, logs and GitHub tokens stay on your computer.
Will my computer warn me when I install it?
On a Mac, no more than usual: both installers are signed with an Apple Developer ID and notarized, so macOS just asks once whether to open an app downloaded from the internet. On Windows, it might: the installer isn't code-signed yet, so SmartScreen can show a "Windows protected your PC" message. Each release lists SHA-256 checksums so you can confirm the file is the one we published.
Does it update itself?
Not yet. There's no automatic updater in the preview, so download new versions from this site. Mac and Windows releases can arrive separately; the build status above always shows the current version for each.
What happens if I hit a rate limit?
GitHub and GitLab limit how many API requests you can make without an account. When you reach the limit, Reporun shows a live countdown and the local time you can try again, taken from the provider's response. It won't keep retrying in the background. For more headroom, add a fine-grained, read-only GitHub token under Settings → GitHub connection. It's only sent to GitHub's API, never to GitLab or the account service.
Can I trust a "ready" result completely?
Treat it as a strong starting point. Reporun reads what a project declares. Undocumented steps, credentials and external services are outside what it can see, and the report tells you when a file couldn't be read or a version format isn't supported.