otty / apps

All apps/Go

Go

An open source programming language that makes it easy to build simple, reliable, and efficient software.

Runs as go|macOS, Linux, Windows|go.dev

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Go in your home directory Every rule on this page, by file

GOPATHGOBINGOCACHEGOMODCACHEGOTMPDIR

Each machine keeps its own copy of these.

· ~/go/pkg/mod/ Exclude

· ~/Library/Caches/go-build/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/go/otty.tomlThe file this page is generated from

id = "go"

name = "Go"

homepage = "https://go.dev"

description = "An open source programming language that makes it easy to build simple, reliable, and efficient software."

icon = "SimpleIcons:go"

executables = ["go"]

[dotfiles]

# `go help environment`: "Defaults changed using 'go env -w' are recorded in a

# Go environment configuration file stored in the per-user configuration

# directory, as reported by os.UserConfigDir." os.UserConfigDir is the

# [appData] base directory: ~/Library/Application Support on macOS,

# $XDG_CONFIG_HOME (default ~/.config) on Linux and %AppData% on Windows.

# `go env GOENV` prints the effective file; on macOS it answers

# ~/Library/Application Support/go/env, which is why the XDG spelling — that is,

# [configHome] — would be wrong there.

paths = ["[appData]/go/env"]

# The module cache (GOMODCACHE, $GOPATH/pkg/mod by default) and the build cache

# (GOCACHE, os.UserCacheDir + "/go-build") are downloads and compiler output.

exclude = [

"~/go/pkg/mod/",

"[cacheHome]/go-build/",

]

# Module credentials live in ~/.netrc or a GOAUTH helper, never in this file.

secret = []

# Re-read by every `go` invocation; the toolchain is not resident.

side_effect = false

# GOPATH, GOBIN, GOCACHE, GOMODCACHE and GOTMPDIR are directories on this

# machine's disk; GOPROXY, GOPRIVATE, GOFLAGS and GOTOOLCHAIN are the settings a

# developer wants everywhere. The five are written with this user's home

# expanded and are only in the file because `go env -w` put them there, so they

# are kept to set this machine up again: backup.

[[dotfiles.machine_lines]]

file = "[appData]/go/env"

match = { prefix = ["GOPATH", "GOBIN", "GOCACHE", "GOMODCACHE", "GOTMPDIR"] }

scope = "backup"

[commands]

format = 1

label = "Go toolchain"

description = "Build, test, run, format and manage modules. Flags come from the Fig completion data, which omits some options (for example -run and -count for go test)."

quality = "ai-draft"

base = "fig:go"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand]]

path = ["build"]

label = "Build packages"

description = "Compile packages and dependencies."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "packages"

label = "Packages"

description = "Defaults to the package in the current directory."

type = "path"

position = 0

path = { kind = "any", role = "input" }

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "output"

label = "Output"

description = "File or directory for the result."

type = "path"

option = ["-o"]

path = { kind = "any", role = "output" }

effect = "overwrite"

sources = ["fig"]

[[commands.subcommand.field]]

id = "v"

label = "Verbose"

description = "Print package names as they are compiled."

type = "boolean"

option = ["-v"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "race"

label = "Race detector"

type = "boolean"

option = ["-race"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "trimpath"

label = "Trim paths"

type = "boolean"

option = ["-trimpath"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "tags"

label = "Build tags"

description = "Comma-separated list of build tags."

type = "string"

option = ["-tags"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "ldflags"

label = "Linker flags"

description = "Arguments passed to go tool link."

type = "string"

option = ["-ldflags"]

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "mod"

label = "Module mode"

type = "string"

option = ["-mod"]

suggestions = [{ value = "readonly", label = "readonly" }, { value = "vendor", label = "vendor" }, { value = "mod", label = "mod" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "a"

label = "Force rebuild"

type = "boolean"

option = ["-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "n"

label = "Print only"

description = "Print the commands but do not run them."

type = "boolean"

option = ["-n"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "x"

label = "Print commands"

type = "boolean"

option = ["-x"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "build"

label = "Build"

fields = ["packages", "output", "v"]

required = []

[[commands.subcommand.task]]

id = "release"

label = "Trimmed build"

fields = ["packages", "output", "trimpath", "ldflags"]

required = []

set = { trimpath = [true] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["packages", "output", "v", "race", "trimpath"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["a", "n", "x", "mod", "ldflags", "tags"]

[[commands.subcommand]]

path = ["test"]

label = "Test packages"

description = "Run tests in the current package (the package list is not offered; add it after the flags)."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "v"

label = "Verbose"

description = "Print package names as they are compiled."

type = "boolean"

option = ["-v"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "race"

label = "Race detector"

type = "boolean"

option = ["-race"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "trimpath"

label = "Trim paths"

type = "boolean"

option = ["-trimpath"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "tags"

label = "Build tags"

description = "Comma-separated list of build tags."

type = "string"

option = ["-tags"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "mod"

label = "Module mode"

type = "string"

option = ["-mod"]

suggestions = [{ value = "readonly", label = "readonly" }, { value = "vendor", label = "vendor" }, { value = "mod", label = "mod" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "a"

label = "Force rebuild"

type = "boolean"

option = ["-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "n"

label = "Print only"

description = "Print the commands but do not run them."

type = "boolean"

option = ["-n"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "x"

label = "Print commands"

type = "boolean"

option = ["-x"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "json"

label = "JSON output"

type = "boolean"

option = ["-json"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "c"

label = "Compile only"

description = "Compile the test binary without running it."

type = "boolean"

option = ["-c"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "o"

label = "Test binary"

type = "path"

option = ["-o"]

path = { kind = "file", role = "output" }

effect = "overwrite"

sources = ["fig"]

[[commands.subcommand.task]]

id = "verbose"

label = "Verbose tests"

fields = ["v", "race", "tags"]

required = []

set = { v = [true] }

[[commands.subcommand.task]]

id = "json"

label = "JSON results"

fields = ["json", "race"]

required = []

set = { json = [true] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["v", "race", "tags", "json"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["a", "n", "x", "mod", "trimpath", "c", "o"]

[[commands.subcommand]]

path = ["run"]

label = "Run a package"

description = "Compile and run a Go program."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "package"

label = "Package or file"

description = "For example . or main.go."

type = "path"

position = 0

path = { kind = "any", role = "input" }

sources = ["fig"]

[[commands.subcommand.field]]

id = "v"

label = "Verbose"

description = "Print package names as they are compiled."

type = "boolean"

option = ["-v"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "race"

label = "Race detector"

type = "boolean"

option = ["-race"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "trimpath"

label = "Trim paths"

type = "boolean"

option = ["-trimpath"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "tags"

label = "Build tags"

description = "Comma-separated list of build tags."

type = "string"

option = ["-tags"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "mod"

label = "Module mode"

type = "string"

option = ["-mod"]

suggestions = [{ value = "readonly", label = "readonly" }, { value = "vendor", label = "vendor" }, { value = "mod", label = "mod" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "x"

label = "Print commands"

type = "boolean"

option = ["-x"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "run"

label = "Run"

fields = ["package", "race"]

required = ["package"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["package", "race", "tags"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["mod", "trimpath", "v", "x"]

[[commands.subcommand]]

path = ["get"]

label = "Add a dependency"

description = "Add a dependency to the current module and install it."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "url"

label = "Module"

description = "Module path with an optional @version."

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "u"

label = "Update"

description = "Update to newer minor or patch releases."

type = "boolean"

option = ["-u"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "t"

label = "Include tests"

type = "boolean"

option = ["-t"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "d"

label = "Download only"

type = "boolean"

option = ["-d"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "v"

label = "Verbose"

type = "boolean"

option = ["-v"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "add"

label = "Add module"

fields = ["url", "u"]

required = ["url"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["url", "u", "t", "d", "v"]

[[commands.subcommand]]

path = ["mod", "tidy"]

label = "Tidy go.mod"

description = "Make go.mod match the source code in the module."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "e"

label = "Proceed despite errors"

type = "boolean"

option = ["-e"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "v"

label = "Verbose"

description = "Print information about removed modules."

type = "boolean"

option = ["-v"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "tidy"

label = "Tidy"

fields = ["v"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["e", "v"]

[[commands.subcommand]]

path = ["fmt"]

label = "Format sources"

description = "Reformat package sources with gofmt."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/go.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "packages"

label = "Packages"

description = "Defaults to the current package."

type = "path"

position = 0

path = { kind = "any", role = "input" }

multiple = true

sources = ["fig"]

[[commands.subcommand.field]]

id = "n"

label = "Print only"

description = "Print the commands that would run."

type = "boolean"

option = ["-n"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "x"

label = "Print commands"

type = "boolean"

option = ["-x"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "fmt"

label = "Format"

fields = ["packages"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["packages", "n", "x"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/go. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits GOPATH and GOBIN for you — that part is Otty’s own sync, or a template you write by hand.