Open Source — MIT License

runx
save once,
run from anywhere

Stop navigating to project directories and remembering start commands. Register a project once and launch it instantly from anywhere on your system.

Download View Source
~ anywhere on your machine
$ runx add
? Project name my-api
? Project path (directory browser)
  ▸ ~/projects/
  ▸ ~/projects/my-api/ ← selected
? Run command go run . (auto-detected)
✓ Project "my-api" saved.
$ runx run my-api
▶ go run . ~/projects/my-api
Server running on :8080

Everything you need, nothing you don't

A focused tool that does one thing well.

🧙

Interactive Wizard

Run runx add to launch a wizard with a built-in directory browser — no path copying needed.

Auto-Detection

Automatically detects run commands for Go, Node, Python, Rust and more — no manual config needed.

📍

Run from Anywhere

Projects are registered globally. Run any project from any directory — no cd required.

🔧

Easy to Edit

Update a project's path or command anytime with runx edit. Re-detection happens automatically.

🎯

Pass Extra Args

Forward flags to your underlying command with --. Works exactly as you'd expect.

📂

runx here

Already inside your project? Run runx here — name defaults to the directory name, command is auto-detected.

🌍

Cross-Platform

Native binaries for macOS, Linux, and Windows on both amd64 and arm64 architectures.


How it works

A handful of commands cover everything.

1

Register a project

Run runx add for the wizard with a directory browser, runx here if you're already inside the project, or pass --path directly. The run command is auto-detected.

2

Saved to ~/.runx/projects.json

Projects are stored locally in a simple JSON file. Override the location with RUNX_CONFIG_DIR if you need to.

3

Run from anywhere

Use runx run <name> from any directory. runx changes into the project path and executes the saved command.

4

Manage with ease

Use runx list to see all projects, runx edit to update them, and runx remove to clean up.


Get started in seconds

Available via Homebrew, Go, or direct download.

Homebrew
brew install ChengaDev/tap/runx

Also available via  go install  or  pre-built binary


Built with

Minimal dependencies, maximum reliability.

Go cobra Bubble Tea / huh macOS Linux Windows amd64 arm64 MIT License