Quikrun

Run your code files without hassle

Quikrun is a cross platform CLI tool for running code files instantly without typing complex commands in your terminal.

• Auto language Detection: Auto-detects language by extension or shebang headers (#!).
• Sane Defaults: Default command templates preconfigured with generally recommended compiler/interpreter flags.
• Highly Configurable: Add new languages or override behavior to suit your own taste
• Argument Forwarding: Safely forward arguments/flags to your scripts easily, with support for POSIX -- separator.

paru -S quikrun

# or
yay -S quikrun

If there is not package for your distro/OS, you can install directly:

# Using uv (highly recommended for global installation)
uv tool install quikrun

# Using pipx (another good way to install globally)
pipx install quikrun

# Using pip (if you wanna install locally in a project)
pip install quikrun

Simply pass your file to quikrun:

quikrun main.py   # runs with python3
quikrun hello.c   # compiles using gcc and runs the binary

• For simple cases with no flag conflicts:

  quikrun script.py arg1 arg2

• Use the -- separator to forcely forward instead of quikrun:

  quikrun script.py -- --verbose --threads 4

quikrun merges config options in a hierarchy (highest priority wins):

1. Project: quikrun.toml in your current working directory.
2. Project: [tool.quikrun] table inside pyproject.toml.
3. Project: [package.metadata.quikrun] table inside Cargo.toml.
4. Project: "quikrun" key inside package.json.
5. User: ~/.config/quikrun/config.toml (XDG-compliant).
6. Built-in: Default fallbacks for common languages.

For customization, default commands, or custom commands, check out Documentation: