Documentation

Introduction

devrunner is a universal task runner designed to eliminate the mental context switching between different project environments. It serves as a unified interface for your build tools.

Instead of remembering npm run build, mvn package, or cargo build, you simply run devrunner build. The tool automatically detects the project type and invokes the correct command.

Installation

Install devrunner on your local machine. It comes as a single binary with zero dependencies.

Usage

The standard syntax is:

devrunner [command] [args...]

Basic Workflow

Navigate to any project directory (or subdirectory) and run commands:

# Run your test suite
$ devrunner test

# Start development server
$ devrunner start

# Lint codebase
$ devrunner lint

Passing Arguments

To pass flags directly to the underlying tool, use the -- separator:

# Equivalent to "npm run test -- --watch"
$ devrunner test -- --watch

Configuration

Global configuration is stored in ~/.config/devrunner/config.toml.

# ~/.config/devrunner/config.toml

[config]
# Automatically check for updates (default: true)
auto_update = true

# Skip detection for specific tools
ignore_tools = ["make"]

# Enable detailed logging
verbose = false