New to Go? We recommend checking out Go by Example to get up to speed.

Local development

To run the code for your challenge locally, you’ll need go installed. Our test runners use go version 1.19 (as of November 2023).

The script for your challenge (like ./ will automatically compile your code using go build before executing it.

File structure

  • The files for your solution are placed in the app/ directory.
  • app/main.go contains the main function, which is what the test runner executes.

Adding more files

You can add more files and directories to app/. The test runner will include them when compiling your code.

For example, if you added a file at app/foo.go, you could use it like so:

package main

fun foo() {
    println("Hello world!")

All files in app/ must have a package main declaration at the top of the file. If you want to extract files into a different package, you can create a new folder in app/ and add the package declaration to the top of each file in that folder.

Let’s say you wanted to extract foo.go into the bar package. You’d move foo.go into the app/bar and add the relevant package declaration to the top of foo.go:

package bar

fun foo() {
    println("Hello world!")

Note that you’ll need to update the import statement in main.go to use the new package name (Example: You’ll find the first part of the package name in go.mod.

Adding dependencies

You can add dependencies to your project by adding them to your go.mod file. You can use the go get command for this.

For example, to add the library, you can run the following command:

$ go get

# Output:
# go: downloading v1.8.0
# go: downloading v1.1.0
# go: added v1.8.0

This’ll add the following line to your go.mod file:

require v1.1.3

It’ll also make changes to your go.sum file.

When you push your code next, the runner will automatically download the dependency.

You can use the dependency in your code like so:

package main

import (

func main() {
    var rootCmd = &cobra.Command{
        Use:   "test",
        Short: "test",
        Run: func(cmd *cobra.Command, args []string) {
            // Do Stuff Here


Was this page helpful?