Describe your devops-tools, run them fast

Run’em runs a project's dev-ops tasks, in parallel, and gives you a blueprint of what those tasks are. Commands are instantly discoverable, run in parallel, and easily extensible.

• Jobs Manifest - discover tasks & onboard smoothly
• Parallel - get results quicker
• Simple - define task easily
• Extensible - add tasks, & reports quickly
• Filters - powerful task selection
• Visibility - see what you're running, & discover improvements.
• Beautiful - get graphs & metrics out of the box, then build custom reports.

The Jobs manifest (available via runem --help) gives you an overview and insights into all job and tasks for a project. A single source of truth for all tasks.

This allows faster on-boarding, easier discovery, and better team communication. It makes access and visibility of tasks easier and better.

Save time by running dev-ops tasks in parallel, and by getting metrics on those runtimes.

Runem tries to run all tasks as quickly as possible, looking at resources, with dependencies.

NOTE: It is not yet a full resource analyser or dependency-execution graph, but by version 1.0.0 it will be.

Use powerful and flexible filtering. Select or excluded tasks by tags, name and phase. Chose the task to be run based on your needs, right now.

You can also customise filtering by adding your own command options.

See --tags, --not-tags, --jobs, --not-jobs, --phases and --not-phases.

Understand what ran, how fast, and what failed.

Quiet by Default: Focus on what matters, and reveal detail only when needed.

Install:

pip install runem

Optional shell completion (bash/zsh/fish):

pip install "runem[completion]"

Define a task:

`# .runem.yml
 - job:
    command: echo "hello world!"

Run:

runem

Run multiple commands in parallel, see timing, and keep output minimal. Need detail?

runem --verbose

Quick Start Docs

Typical workflows are running all default jobs, filtering and viewing the job manifest & help: Filter runem --help is your radar—instantly mapping out every available task: Help & Job Discovery

Agents can use the structured MCP server instead of scraping help output: Agent MCP Server

How and why to configure your projects .runem.yml file. How to scale up with multi-phase configs, how to apply filters and how to configure runtime options: Configuration

runem gives you basic performance metrics by default, and allows custom reporting like code-coverage, or profiling reports: Reports

Swift solutions to common issues: Troubleshooting & Known Issues

Brought to you by Lursight Ltd. and an open community. CONTRIBUTING.md ❤️ Sponsor

Run’em exists to accelerate your team’s delivery and reduce complexity. Learn about our Mission.