{"id":14110442,"url":"https://github.com/asdf-community/asdf-golang","last_synced_at":"2026-03-11T13:30:41.413Z","repository":{"id":4332119,"uuid":"52771951","full_name":"asdf-community/asdf-golang","owner":"asdf-community","description":"Go plugin for the asdf version manager [maintainer=@kennyp]","archived":false,"fork":false,"pushed_at":"2026-03-04T04:32:17.000Z","size":96,"stargazers_count":638,"open_issues_count":26,"forks_count":101,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-03-04T09:43:53.763Z","etag":null,"topics":["asdf","asdf-plugin"],"latest_commit_sha":null,"homepage":"https://github.com/asdf-vm/asdf","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asdf-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["smorimoto"]}},"created_at":"2016-02-29T07:18:53.000Z","updated_at":"2026-03-04T04:28:31.000Z","dependencies_parsed_at":"2025-10-24T04:31:44.439Z","dependency_job_id":null,"html_url":"https://github.com/asdf-community/asdf-golang","commit_stats":{"total_commits":81,"total_committers":40,"mean_commits":2.025,"dds":0.6049382716049383,"last_synced_commit":"33b1f6d73a408b32dee8c93b1763c0ba102ee45d"},"previous_names":["asdf-community/asdf-golang","kennyp/asdf-golang"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/asdf-community/asdf-golang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-golang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-golang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-golang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-golang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asdf-community","download_url":"https://codeload.github.com/asdf-community/asdf-golang/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asdf-community%2Fasdf-golang/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30382673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T12:49:11.341Z","status":"ssl_error","status_checked_at":"2026-03-11T12:46:41.342Z","response_time":84,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asdf","asdf-plugin"],"created_at":"2024-08-14T10:02:51.172Z","updated_at":"2026-03-11T13:30:41.381Z","avatar_url":"https://github.com/asdf-community.png","language":"Shell","funding_links":["https://github.com/sponsors/smorimoto"],"categories":["Shell"],"sub_categories":[],"readme":"# asdf-golang\n\n[![CI](https://github.com/asdf-community/asdf-golang/actions/workflows/main.yml/badge.svg)](https://github.com/asdf-community/asdf-golang/actions/workflows/main.yml)\n\ngolang plugin for [asdf version manager](https://github.com/asdf-vm/asdf)\n\n## Requirements\n\n### MacOS\n\n* [GNU Core Utils](http://www.gnu.org/software/coreutils/coreutils.html) - `brew install coreutils`\n\n### Linux (Debian)\n\n* [GNU Core Utils](http://www.gnu.org/software/coreutils/coreutils.html) - `apt install coreutils`\n* [curl](https://curl.haxx.se) - `apt install curl`\n\n## Install\n\n```bash\nasdf plugin add golang https://github.com/asdf-community/asdf-golang.git\n```\n\n## Use\n\nTo ensure the Golang environment variables are correctly set when using the `asdf` Go plugin (`asdf-golang`), you should source the appropriate `set-env` script for your shell. This is particularly important if you've customized the `asdf` data directory using the `ASDF_DATA_DIR` environment variable. Below are instructions for various shells:\n\n- **Zsh (`.zshrc`):**\n\n  ```bash\n  . ${ASDF_DATA_DIR:-$HOME/.asdf}/plugins/golang/set-env.zsh\n  ```\n\n- **Bash (`.bashrc`):**\n\n  ```bash\n  . ${ASDF_DATA_DIR:-$HOME/.asdf}/plugins/golang/set-env.bash\n  ```\n\n- **Fish (`config.fish`):**\n\n  ```fish\n  source (echo $ASDF_DATA_DIR | if test -z $it; echo $HOME/.asdf; else echo $it; end)/plugins/golang/set-env.fish\n  ```\n\n- **Nushell (`env.nu`):**\n\n  ```nu\n  source (if ($env.ASDF_DATA_DIR | empty?) { echo $nu.env.HOME/.asdf } { echo $env.ASDF_DATA_DIR })/plugins/golang/set-env.nu\n  ```\n\n## When using `go get` or `go install`\n\nAfter using `go get` or `go install` to install a package you need to run `asdf reshim golang` to get any new shims.\n\n### Default `go get` packages\n\nasdf-golang can automatically install a default set of packages with `go get -u $PACKAGE` right after installing a new Go version.\nTo enable this feature, provide a \\$HOME/.default-golang-pkgs file that lists one package per line, for example:\n\n```bash\n// allows comments\ngithub.com/Dreamacro/clash\ngithub.com/jesseduffield/lazygit\n```\n\nYou can specify a non-default location of this file by setting a `ASDF_GOLANG_DEFAULT_PACKAGES_FILE` variable.\n\n## Version selection\n\nWhen using `.tool-versions` or `.go-version`, the exact version specified in the\nfile will be selected.\n\nWhen using `go.mod`, the highest compatible version that is currently installed\nwill be selected. As per the [Go modules\nreference](https://golang.org/ref/mod#go-mod-file-go), that is the highest minor\nversion with a matching major version. For example, a `go 1.14` directive in a\n`go.mod` file will result in the highest installed `1.minor.patch` being\nselected, not necessarily `1.14.patch`.\n\n**Note**: Users can explicitly exclude or include `go.mod` and `go.work` by\nsetting `ASDF_GOLANG_MOD_VERSION_ENABLED`. Currently it defaults to `true`, but that\nmay change in the future, so it should be explicitly set.\n\n## Architecture Override\n\nThe `ASDF_GOLANG_OVERWRITE_ARCH` variable can be used to override the architecture \nthat is used for determining which Go build to download. The primary use case is when attempting \nto install an older version of Go for use on an Apple M1 computer as Go was not being built for ARM at the time.\n\n#### Without ASDF_GOLANG_OVERWRITE_ARCH\n\n```\n\u003e asdf install golang 1.15.8\nPlatform 'darwin' supported!\nURL: https://dl.google.com/go/go1.15.8.darwin-arm64.tar.gz returned status 404\n```\n\n#### With ASDF_GOLANG_OVERWRITE_ARCH\n\n```\n\u003e ASDF_GOLANG_OVERWRITE_ARCH=amd64 asdf install golang 1.15.8\nPlatform 'darwin' supported!\n  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current\n                                 Dload  Upload   Total   Spent    Left  Speed\n100  116M  100  116M    0     0  98.6M      0  0:00:01  0:00:01 --:--:-- 98.6M\nverifying checksum\n/Users/\u003chome\u003e/.asdf/downloads/golang/1.15.8/archive.tar.gz: OK\nchecksum verified\n```\n\n## Skipping Checksums\n\nBy default we try to verify the checksum of each install but ocassionally [that's not possible](https://github.com/asdf-community/asdf-golang/issues/91).\nIf you need to skip the checksum for some reason just set `ASDF_GOLANG_SKIP_CHECKSUM`.\n\n## Contributing\n\nFeel free to create an issue or pull request if you find a bug.\n\n## Issues\n\n* Assumes Linux, FreeBSD, or Mac\n* Assumes x86_64, i386, i686, armv6l, armv7l, arm64 and ppc64le\n\n## License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasdf-community%2Fasdf-golang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasdf-community%2Fasdf-golang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasdf-community%2Fasdf-golang/lists"}