3.3 Subcommands

ergo fetch [<designator>]

clone or pull the project and its dependencies, obeying the lock file; no build.

ergo build [<designator>]

fetch, then build the project and its dependencies.

ergo test [<designator>]

fetch, build, then run the tests.

ergo run [<designator>] [-- <argument>…]

fetch, build, then run the project; the arguments after ‘--’ are passed to the program.

ergo all [<designator>]

fetch, build, test, and if possible run.

ergo repl [<designator>]

start the interactive environment of the project with the project loaded: a Common Lisp REPL for asdf projects, an AutoLISP REPL for alpm projects, a shell in the project directory otherwise.

ergo update [<component>…]

re-resolve the loose designators of the project file — all of them, or only the given components — and rewrite the lock file.

ergo search <name>

search the collections for repositories matching ‘name’; ‘--collections <c1>,<c2>,…’ restricts the search.

ergo where-from [<component>]

report the provenance: url, branch, tag, or commit.

ergo where-is [<component>]

print the directory of the local clone.

ergo uninstall <designator>

drop one repository’s clone from the cache — its bare mirror and every per-ref worktree. Unlike ‘ergo gc’, which sweeps worktrees no lock still references, this removes one repository outright.

ergo search <name> --installed

restrict a search to the repositories already materialized in the local cache.

ergo status

report the current project, the freshness of the lock file, and any local modification in the clones.

ergo init [<designator>]

create an ‘ergo’ project file in the current directory, inferring the class of project and the dependencies; with a designator, fetch that project first.

ergo collections

list the collection database, in search order, with the layer providing each collection.

ergo clean

remove the build products of the project.