Subcommands like tinygo flash and tinygo version.

TinyGo tries to be similar to the main go command in usage. It consists of the following main subcommands:


Compile the given program. The output binary is specified using the -o parameter. The generated file type depends on the extension:

.o Create a relocatable object file. You can use this option if you don’t want to use the TinyGo build system or want to do other custom things.

.ll Create textual LLVM IR, after optimization. This is mainly useful for debugging.

.bc Create LLVM bitcode, after optimization. This may be useful for debugging or for linking into other programs using LTO.

.hex Create an Intel HEX file to flash it to a microcontroller.

.bin Similar, but create a binary file.

.wasm Compile and link a WebAssembly file.

(all other) Compile and link the program into a regular executable. For microcontrollers, it is common to use the .elf file extension to indicate a linked ELF file is generated. For Linux, it is common to build binaries with no extension at all.


Run the program, either directly on the host or in an emulated environment (depending on -target).


Flash the program to a microcontroller.


Compile the program, optionally flash it to a microcontroller if it is a remote target, and drop into a GDB shell. From there you can set breakpoints, start the program with run or continue (run for a local program, continue for on-chip debugging), single-step, show a backtrace, break and resume the program with Ctrl-C/continue, etc. You may need to install extra tools (like openocd and arm-none-eabi-gdb) to be able to do this. Also, you may need a dedicated debugger to be able to debug certain boards if no debugger is integrated. Some boards (like the BBC micro:bit and most professional evaluation boards) have an integrated debugger.


Clean the cache directory, normally stored in $HOME/.cache/tinygo. This is not normally needed.


Print a short summary of the available commands, plus a list of command flags.


Print the version of the command and the version of the used $GOROOT.


Print a list of environment variables that affect TinyGo (as a shell script). If one or more variable names are given as arguments, env prints the value of each on a new line.