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

# atlas(1)

Atlas

## NAME

atlas - Atlas

## DESCRIPTION

atlas - Nim Package Cloner Version 0.14.7 (sha: aa6fb162006f3015aa84c4305e15cb4d230f5ad6)

-

  (c) 2021 Andreas Rumpf

### Usage:

-

  atlas \[options\] \[command\] \[arguments\]

### Commands:

- init

  initializes the current project as an Atlas project

- use \<url\|pkgname\>

  add package and its dependencies to the project and patch the project's Nimble file

- install

  use the nimble file to setup the project's dependencies

- update \[filter\]

  update every dependency that matches the filter whether by name or URL. All dependencies are updated if no filter is given.

- search \<keyA\> \[keyB ...\]

  search for package that contains the given keywords

- link \<path\>

  link an existing project into the current project to share its dependencies

- tag \[major\|minor\|patch\|\<semver\>\|a..z\]

  add and push a new tag, input must be one of: \['major'\|'minor'\|'patch'\] or a SemVer tag like \['1.0.3'\] or a letter \['a'..'z'\]: a.b.c.d.e.f.g

- pin \[atlas.lock\]

  pin the current checkouts and store them in the lock file

- rep \[atlas.lock\]

  replay the state of projects according to the lock file

- replay \[atlas.lock\]

  alias of \`rep\`

- reproduce \[atlas.lock\]

  alias of \`rep\`

- changed \[atlas.lock\]

  list any packages that differ from the lock file

- outdated

  list the packages that are outdated

- deps

  list the currently selected dependencies

- env \<nimversion\>

  setup a Nim virtual environment

## OPTIONS

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

  show this help

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

  show the version

- **--project**=*path*, **-p**

  use the project at the given path

- **--deps**=*path*

  override the deps directory

- **--confdir**=*path*

  use the atlas.config at the given path

- **--feature=**\<feature\>

  enables the given feature, pass multiple for multiple features for project specific use: \`\<project\>.\<feature\>\` (note always be passed when you want to use features)

- **--features=**\<list\>

  enables one or more features separated by commas or spaces

- **--allFeatures**

  enables every declared feature

- **--keepFeatures**, **-k**

  reuse feature defines from the current nim.cfg

- **--resolver**=*minver*\|semver\|maxver

  which resolution algorithm to use, default is semver

- **--list\[**=*on*\|off\]

  list all available and installed versions

- **--keepCommits**

  do not perform any \`git checkouts\`

- **--keepworkspace**

  keep generated workspace artifacts

- **--ignoreerrors**

  continue even when errors were recorded

- **--dumpformular**

  dump SAT formula for debugging

- **--dumpgraphs**

  dump dependency graphs for debugging

- **--showGraph**

  show the dependency graph

- **--tree**

  show \`atlas deps\` output as a dependency tree

- **--update**

  for \`install\`, update dependency repos before solving

- **--noexec**

  do not perform any action that may run arbitrary code

- **--autoenv**

  detect the minimal Nim $version and setup a corresponding Nim virtual environment

- **--noautoinit**

  do not auto initialize an atlas project

- **--no-lazy-deps**

  disable lazy dependency loading and use eager loading for all transitive dependencies during SAT solving

- **--parallel**\[=*count*\], **-t**\[=*count*\]

  clone dependency repositories in parallel, default count is 3

- **--proxy**=*url*

  use the given proxy URL for all git operations

- **--dumbProxy**

  use a dumb proxy without smart git protocol

- **--packagesRepo**

  use the nim-lang/packages git repo (legacy behavior)

- **--forceGitToHttps**

  force git:// URLs to https://

- **--ignoreUrls**

  don't error on mismatching urls

- **--colors**=*on*\|off

  turn on\|off colored output

- **--verbosity**=*normal*\|info\|warn\|warning\|error\|trace\|debug

  set verbosity level to normal/info/warn/warning/error/trace/debug the default level is warning