ATLAS(1)

📦 version 2.2.12, in arch rolling

🌸 ATLAS(1) — the manual page, bestie edition 🌸

okay so this is atlas, from the User Commands corner of the manual-verse, and honestly? she's a whole vibe. let's get into it 💅

✨ NAME ✨

atlas — Atlas. that's it, that's the name. short, iconic, no notes 🎀

💖 DESCRIPTION 💖

atlas — the Nim Package Cloner, Version 0.14.7 (sha: aa6fb162006f3015aa84c4305e15cb4d230f5ad6).

(c) 2021 Andreas Rumpf — give the icon his flowers 👑

🦋 Usage

atlas [options] [command] [arguments]

like, that's the shape of it. options, then a command, then the arguments. slay.

🌈 Commands

  • init — initializes the current project as an Atlas project. main character move, sets the whole thing up.
  • use <url|pkgname> — add package and its dependencies to the project, and patch the project's Nimble file. yes it edits your Nimble file. that's literally the job.
  • install — use the nimble file to setup the project's dependencies. let the nimble file cook 🍓
  • update [filter] — update every dependency that matches the filter, whether by name or URL. no filter given? then all the dependencies get updated. periodt.
  • search <keyA> [keyB ...] — search for a package that contains the given keywords. give it one keyword or a whole lil squad of them.
  • link <path> — link an existing project into the current project so they can share its dependencies. friendship bracelet but for deps 🫶
  • tag [major|minor|patch|<semver>|a..z] — add and push a new tag. the input has to 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. pick one, don't be chaotic about it.
  • pin [atlas.lock] — pin the current checkouts and store them in the lock file. freeze the moment, literally.
  • rep [atlas.lock] — replay the state of projects according to the lock file. rewind time bestie ⭐
  • replay [atlas.lock] — alias of rep. same energy, different name.
  • reproduce [atlas.lock] — alias of rep. yes, a third name. she contains multitudes.
  • changed [atlas.lock] — list any packages that differ from the lock file. the "who changed and why" command 💀
  • outdated — list the packages that are outdated. the callout post.
  • deps — list the currently selected dependencies.
  • env <nimversion> — setup a Nim virtual environment. cute lil bubble for your Nim.

🧚 OPTIONS 🧚

  • --help, -h — show this help. you know this one.
  • --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 it multiple times for multiple features. for project specific use: <project>.<feature> (note: it always needs to be passed when you want to use features — like, always, no skipping 🙈).
  • --features=<list> — enables one or more features, separated by commas or spaces.
  • --allFeatures — enables every declared feature. all of them. no crumbs left.
  • --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. bold. brave. slightly unhinged 🔥
  • --dumpformular — dump SAT formula for debugging. yes, it's spelled formular, don't come for me, I'm just the messenger.
  • --dumpgraphs — dump dependency graphs for debugging.
  • --showGraph — show the dependency graph. pretty pictures ✨
  • --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. the safety-girlie option, keep her close 🔒
  • --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. eager beaver mode 🐝
  • --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. (her words, not mine 😭)
  • --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. (turn it on, bestie, life's too short for monochrome 🎨)
  • --verbosity=normal|info|warn|warning|error|trace|debug — set verbosity level to normal/info/warn/warning/error/trace/debug. the default level is warning.
💜 reminder bestie: --noexec exists for a reason — it keeps things from running arbitrary code. use her when you're being careful.

and that's the page!! 💅 this was atlas 2.2.12, dated September 2026 — mwah, go clone some packages, ily, bye 🎀✨🦋

📦 where this page comes from