ATLAS(1)                         User Commands                        ATLAS(1)

NAME
       atlas - Atlas

DESCRIPTION
       atlas - Nim Package Cloner Version 0.10.1 (sha:
       ff1f4289482dce94ba9f95b3b0ae16d16e21eb3d)

              (c) 2021 Andreas Rumpf

   Usage:
              atlas [options] [command] [arguments]

   Command:
       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

       extract <file.nimble> extract the requirements and custom commands from
              the given Nimble file

       tag [major|minor|patch]
              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 the projects according to the lock file

       changed <atlas.lock>
              list any packages that differ from the lock file

       outdated
              list the packages that are outdated

       build|test|doc|tasks
              currently delegates to `nimble build|test|doc`

       task <taskname>
              currently delegates to `nimble <taskname>`

       env <nimversion>
              setup a Nim virtual environment

       --keep keep the c_code subdirectory

OPTIONS
       --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)

       --keepCommits
              do not perform any `git checkouts`

       --project=path
              use the project at the given path

       --confdir=path
              use the atlas.config at the given path

       --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

       --resolver=minver|semver|maxver
              which resolution algorithm to use, default is semver

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

       --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)

       --showGraph
              show the dependency graph

       --list list all available and installed versions

       --version
              show the version

       --ignoreUrls
              don't error on mismatching urls

       --colors=on|off
              turn on|off colored output

       --verbosity=info|warning|error|trace|debug
              set verbosity level to info, warning, error, trace, debug the
              default level is warning

       --help show this help

atlas 2.2.10                      April 2026                          ATLAS(1)