---
name: "nim"
section: "1"
platform: "linux"
package: "nim"
version: "2.2.12-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/nim"
---

# nim(1)

Nim Language Compiler

## NAME

nim - Nim Language Compiler

## DESCRIPTION

Nim Compiler Version 2.2.12 \[Linux: amd64\] Compiled at 2026-09-07 Copyright © 2006-2026 by Andreas Rumpf

-

  nim command \[options\] \[projectfile\] \[arguments\]

### Command:

- compile, c

  compile project with default code generator (C)

- r

  compile to *$nimcache/projname*, run with \`arguments\` using backend specified by \`--backend\` (default: c)

- doc

  generate the documentation for inputfile for backend specified by \`--backend\` (default: c)

### Arguments:

-

  arguments are passed to the program being run (if **--run** option is selected)

## OPTIONS

- **-p**, **--path**:PATH

  add path to search paths

- **-d**, **--define**:SYMBOL(:VAL)

  define a conditional symbol (Optionally: Define the value for that symbol, see: "compile time define pragmas")

- **-u**, **--undef**:SYMBOL

  undefine a conditional symbol

- **-f**, **--forceBuild**:on\|off

  force rebuilding of all modules

- **--stackTrace**:on\|off

  turn stack tracing on\|off

- **--lineTrace**:on\|off

  turn line tracing on\|off

- **--threads**:on\|off

  turn support for multi-threading on\|off

- **-x**, **--checks**:on\|off

  turn all runtime checks on\|off

- **-a**, **--assertions**:on\|off

  turn assertions on\|off

- **--opt**:none\|speed\|size

  optimize not at all or for speed\|size Note: use **-d**:release for a release build!

- **--debugger**:native

  use native debugger (gdb)

- **--app**:console\|gui\|lib\|staticlib

  generate a console app\|GUI app\|DLL\|static library

- **-r**, **--run**

  run the compiled program with given arguments

- **--eval**:cmd

  evaluate nim code directly; e.g.: \`nim **--eval**:"echo 1"\` defaults to \`e\` (nimscript) but customizable: \`nim r **--eval**:'for a in stdin.lines: echo a'\`

- **--fullhelp**

  show all command line switches

- **-h**, **--help**

  show this help

- **-v**, **--version**

  show detailed version information

Note, single letter options that take an argument require a colon. E.g. **-p**:PATH.