| 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
| April 2026 | atlas 2.2.10 |