.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ATLAS "1" "April 2026" "atlas 2.2.10" "User Commands"
.SH NAME
atlas \- Atlas
.SH DESCRIPTION
atlas \- Nim Package Cloner Version 0.10.1 (sha: ff1f4289482dce94ba9f95b3b0ae16d16e21eb3d)
.IP
(c) 2021 Andreas Rumpf
.SS "Usage:"
.IP
atlas [options] [command] [arguments]
.SS "Command:"
.TP
init
initializes the current project as an Atlas project
.TP
use <url|pkgname>
add package and its dependencies to the project
and patch the project's Nimble file
.TP
install
use the nimble file to setup the project's dependencies
.TP
update [filter]
update every dependency that matches the filter
whether by name or URL. All dependencies are updated
if no filter is given.
.TP
search <keyA> [keyB ...]
search for package that contains the given keywords
.TP
link <path>
link an existing project into the current project
to share its dependencies
.TP
extract <file.nimble> extract the requirements and custom commands from
the given Nimble file
.TP
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
.TP
pin [atlas.lock]
pin the current checkouts and store them in the lock file
.TP
rep [atlas.lock]
replay the state of the projects according to the lock file
.TP
changed <atlas.lock>
list any packages that differ from the lock file
.TP
outdated
list the packages that are outdated
.TP
build|test|doc|tasks
currently delegates to `nimble build|test|doc`
.TP
task <taskname>
currently delegates to `nimble <taskname>`
.TP
env <nimversion>
setup a Nim virtual environment
.TP
\fB\-\-keep\fR
keep the c_code subdirectory
.SH OPTIONS
.TP
\fB\-\-feature=\fR<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)
.TP
\fB\-\-keepCommits\fR
do not perform any `git checkouts`
.TP
\fB\-\-project\fR=\fI\,path\/\fR
use the project at the given path
.TP
\fB\-\-confdir\fR=\fI\,path\/\fR
use the atlas.config at the given path
.TP
\fB\-\-noexec\fR
do not perform any action that may run arbitrary code
.TP
\fB\-\-autoenv\fR
detect the minimal Nim $version and setup a
corresponding Nim virtual environment
.TP
\fB\-\-noautoinit\fR
do not auto initialize an atlas project
.TP
\fB\-\-resolver\fR=\fI\,minver\/\fR|semver|maxver
which resolution algorithm to use, default is semver
.TP
\fB\-\-no\-lazy\-deps\fR
disable lazy dependency loading and use eager loading
for all transitive dependencies during SAT solving
.TP
\fB\-\-proxy\fR=\fI\,url\/\fR
use the given proxy URL for all git operations
.TP
\fB\-\-dumbProxy\fR
use a dumb proxy without smart git protocol
.TP
\fB\-\-packagesRepo\fR
use the nim\-lang/packages git repo (legacy behavior)
.TP
\fB\-\-showGraph\fR
show the dependency graph
.TP
\fB\-\-list\fR
list all available and installed versions
.TP
\fB\-\-version\fR
show the version
.TP
\fB\-\-ignoreUrls\fR
don't error on mismatching urls
.TP
\fB\-\-colors\fR=\fI\,on\/\fR|off
turn on|off colored output
.TP
\fB\-\-verbosity\fR=\fI\,info\/\fR|warning|error|trace|debug
set verbosity level to info, warning, error, trace, debug
the default level is warning
.TP
\fB\-\-help\fR
show this help