run

a.k.a. runtool: the bridge between human and AI tooling

Define functions in a Runfile, run them instantly from your terminal, or expose them as MCP tools for AI agents. Shell, Python, Node—whatever fits the task.

Quick start

# Runfile

# @desc Deploy to an environment
# @arg env Target environment (staging|prod)
# @arg version Version to deploy (defaults to "latest")
deploy(env: str, version = "latest") {
    echo "Deploying $version to $env..."
    ./scripts/deploy.sh $env $version
}

run deploy staging
run deploy prod v2.1.0

Install

• Homebrew: brew install nihilok/tap/runtool
• Scoop: scoop bucket add nihilok https://github.com/nihilok/scoop-bucket then scoop install runtool
• AUR: yay -S runtool (or paru -S runtool)
• Cargo: cargo install run (or runtool)

Documentation

• Getting started
• Runfile syntax, arguments, and variables
• Attributes and interpreters
• Polyglot commands and command composition
• CLI usage
• MCP integration
• Recipes
• Reference and FAQ

License

MIT