# erning/gorun

gorun is a tool enabling one to put a "bang line" in the source code of a Go program to run it, or to run such a source code file explicitly. It was created in an attempt to make experimenting with Go more appealing to people used to Python and similar languages which operate most visibly with source code.

Repository: https://github.com/erning/gorun
Canonical: https://ross.abutalabs.com/products/gorun
Homepage: https://wiki.ubuntu.com/gorun
Language: Go
License: GPL-3.0
License Family: copyleft
Last push: 2023-03-15T02:37:41+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5104, "days_push": 1268, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1026, forks 77 (observed 2026-08-28T04:03:16.705444+00:00)

## What it is
gorun is a CLI tool that lets Go source files be executed directly as scripts via a shebang line, compiling and caching them transparently. It brings Python-style source-file execution to Go for quick experimentation and scripting.

## Use cases
- run go files as scripts with a shebang
- execute go source code directly from the command line
- write quick go scripts like python scripts
- experiment with go without creating a project
- cache compiled go scripts for fast repeated execution

## When to choose
- you want to run small Go programs as executable scripts
- you're used to Python-style scripting and want the same workflow in Go
- you need fast, cached execution of Go source files

## When to avoid
- you're building a full Go project with modules and dependencies
- you need cross-compilation or complex build pipelines
- you need a supported, actively developed tool for production scripting

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools, compiler
- domain: developer-tools, programming-languages
- platform: go, cli
- tags: go-scripts, shebang, scripting, golang, command-line, linux, macos

## Member repositories
- erning/gorun (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:16.705444+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:07:57.862597+00:00, confidence not recorded.
  - readme: https://github.com/erning/gorun (fetched 2026-08-28T04:03:16.705444+00:00, sha 76c7e404a9a2)
  - homepage: https://wiki.ubuntu.com/gorun (fetched 2026-08-29T13:08:09.956902+00:00, sha d3c4facb3969)
- Data as of 2026-08-30T08:39:29.467469+00:00.