Liking cljdoc? Tell your friends :D


Point out your outdated dependencies.

GitHub Actions for test workflow GitHub Actions for lint workflow GitHub Actions for dependencies workflow codecov

Clojars Project GitHub Container Registry

Antq requires Clojure 1.10.0 or later.
Basically, antq could work regardless of the Clojure version which your project depends.
If you have a trouble, please see here.

Supported files



Clojure CLI





Provides 2 ways of program and plug-in.






GitHub Actions





Experimental. gradle command must be installed.


Clojure CLI Tools

Disabled by default. See --check-clojure-tools option.


Clojure CLI (deps.edn)

Run the following command for trial.

clojure -Sdeps '{:deps {com.github.liquidz/antq {:mvn/version "RELEASE"}}}' -M -m antq.core

Or add the following alias to your $HOME/.clojure/deps.edn.

 {:outdated {;; Note that it is `:deps`, not `:extra-deps`
             :deps {com.github.liquidz/antq {:mvn/version "RELEASE"}}
             :main-opts ["-m" "antq.core"]}}

Then, run clojure -M:outdated. (run clojure -A:outdated for Clojure CLI Tool or earlier).

Clojure CLI Tools ( or later)

From Clojure CLI ver, tool installation is supported.

# Install tool
clojure -Ttools install-latest :lib com.github.liquidz/antq :as antq
# Uninstall tool
clojure -Ttools remove :tool antq
# Update tool
clojure -Ttools install-latest :tool antq

# Execute
clojure -Tantq outdated
# Execute with parameter
clojure -Tantq outdated :upgrade true
# Show help
clojure -A:deps -Tantq help/doc
# Upgrade oudated dependencies
clojure -Tantq outdated :check-clojure-tools true :upgrade true

Leiningen (as a main program)

Add the following dependency and alias to your $HOME/.lein/profiles.clj.

 {:aliases {"outdated" ["with-profile" "antq" "run" "-m" "antq.core"]}}
 {:dependencies [[com.github.liquidz/antq "RELEASE"]]}

Then, run lein outdated.

Leiningen (as a plugin)

The Leiningen plugin is a newer offering. It tends to be more accurate (since it won’t parse your project.clj, having it evaluated by Leiningen instead). However the :upgrade option will not be supported (since the plugin cannot always know if a given dependency came from a specific profile, middleware, etc).

In order to use it, add the following plugin to your project.clj (or $HOME/.lein/profiles.clj):

 :plugins [[com.github.liquidz/antq "RELEASE"]]
 ;; optional - you can add antq options here:
 :antq {}

Then, run lein antq.

GitHub Actions

Antq can work with GitHub Actions. See antq’s workflow for concrete example.

In another way, you can use the following action.


Antq experimentally supports Gradle. See here for details.


Antq has timeouts for acquiring various information. See here for details.



Upgrade outdated versions interactively. You can use --force option for upgrading without confirmation, and --download option for downloading upgraded dependencies on the fly.

For now, --upgrade option only supports following files.

  • deps.edn

  • shadow-cljs.edn

  • project.clj

  • build.boot

  • pom.xml


Skip version checking for specified artifacts or versions.


# Exclude all versions of specified artifact
# Exclude specific version of specified artifact
# Exclude version range of specified artifact

When you specified a version number, antq will report the latest version excluding only the specified version.

You could also specify dependencies to exclude with :antq/exclude metadata. See Exclusions for more information.

You must specify groupId/artifactId for Java dependencies.


Add search path for projects. Current directory(.) is added by default.

E.g. -d foo --directory=bar:baz will search "foo", "baz" and "bar" directories.


Focus version checking for specified artifacts.

E.g. --focus=com.github.liquidz/antq

You must specify groupId/artifactId for Java dependencies.
focus option is prefer than exclude option.


Skip to search specified project files. Must be one of boot, clojure-cli, github-action, pom, shadow-cljs and leiningen.

E.g. --skip=pom


Customize outputs for outdated dependencies.

E.g. --error-format="::error file={{file}}::{{message}}"

You can use following variables:

Variable NameDescription


A filename containing outdated dependencies.


The artifact name.


The current version.


The latest version.


The latest artifact name. See details: Clojars Verified Group Names policy.


The changes URL in Version Control System. (Nullable)


DEPRECATED. Please use changes-url instead.

The diff URL for Version Control System. (Nullable)


Default error message.

Antq uses Pogonos as a template engine, so you can use Mustache features.

e.g. {{name}}{{#latest-name}} → {{.}}{{/latest-name}}


Reporter NameDescription

table (default)

Report results in a table.


Report results with a custom format. When you use --error-format option, this reporter will be used automatically.


Report results as a JSON format.


Report results as a EDN format.


If download is set and updated dependencies are found, download them at the same time as a convenience. The default action is not to download anything.

antq only downloads upgraded dependencies by --upgrade option.

If you upgrade manually or without the --download option and the version is changed to the latest, the new version will not be downloaded even if you specify the --download option later (because antq does not detect differences).


For java dependencies, ignore versions installed to your local Maven repository(~/.m2/)


Detect all tools installed in ~/.clojure/tools as dependencies. You can also upgrade them with --upgrade option.


Skip checking changes between deps' versions. Disabled by default.


DEPRECATED. Please use --no-changes instead.

Skip checking diff between deps' versions. Disabled by default.


Show changes URLs in table. This option is only available for table reporter. Disabed by default.


Scan outdated transitive dependencies. Disabled by default.

The default scan depth is 5, but it is customizable by the environmental variable ANTQ_TRANSITIVE_MAX_DEPTH.

With this option, the number of reported dependencies tends to be very large, so it is recommended to use it with the --no-changes option. Otherwise, it may take a long time for the results to be reported.

Projects using antq


Copyright © 2020-2024 Masashi Iizuka

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at

Can you improve this documentation? These fine people already did:
liquidz, github-actions, Iizuka Masashi, Travis Jefferson, Christoph Frick, vemv, Andrey Bogoyavlensky, Björn Ebbinghaus & David Harrigan
Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close