clean Ivy2 cache
Latest commit 7c675e3 Aug 21, 2013 @eed3si9n eed3si9n notes
Failed to load latest commit information.
notes notes Aug 21, 2013
project command param. fixes #4 Aug 21, 2013
src/main 0.1.0 Aug 21, 2013
LICENSE readme Oct 22, 2011
README.markdown notes Aug 22, 2013
build.sbt 0.1.0 Aug 22, 2013
ls.sbt command param. fixes #4 Aug 22, 2013


sbt-dirty-money is an sbt plugin for cleaning Ivy2 cache. If you use publish-local to test plugins and libraries, and you find yourself clearing Ivy2 cache often, this is a tool for you.


For sbt 0.12, add the following to your ~/.sbt/plugins/build.sbt:

addSbtPlugin("com.eed3si9n" % "sbt-dirty-money" % "0.0.1")

For sbt 0.13, add the following to your ~/.sbt/0.13/plugins/dirtymoney.sbt:

addSbtPlugin("com.eed3si9n" % "sbt-dirty-money" % "0.1.0")

how to use

cleaning built artifacts

The above automatically adds 4 global tasks to sbt prompt: cleanCacheFiles, cleanCache, cleanLocalFiles, and cleanLocal.

To display what clean-cache would clean, run:

> show cleanCacheFiles
[info] ArrayBuffer(/Users/foo/.ivy2/cache/scala_2.9.1/sbt_0.11.0/org.scalaxb/sbt-scalaxb, /Users/foo/.ivy2/cache/scala_2.9.1/sbt_0.11.0/org.scalaxb/sbt-scalaxb/jars/sbt-scalaxb-0.6.6-SNAPSHOT.jar)

NOTE: This is calculated as ((dir / "cache") ** ("*" + organization + "*") ** ("*" + name + "*")).get where dir is ~/.Ivy2. If there are related projects that include both your organization and name, they would also be cleaned from the cache! (For example, unfiltered/unfiltered would pick up any unfiltered-xxx). To delete the files, run:

> cleanCache

Similarly, to display what cleanLocal would clean, run:

> show cleanLocalFiles
[info] ArrayBuffer(/Users/foo/.ivy2/local/org.scalaxb ...

This is calculated as ((dir / "local") ** ("*" + organization + "*") ** ("*" + name + "*")).get. To delete these files, run:

> cleanLocal

If you cleaning local, it's probably a good idea to clean cache too.

cleaning other artifacts (0.1+ only)

By passing command arguments, you can target other projects as well.

To clean all artifacts that includes both "net.databinder.dispatch" and "dispatch-json4s" that are cached:

> show cleanCacheFiles "net.databinder.dispatch" % "dispatch-json4s"
[info] ArrayBuffer(~/.ivy2/cache/net.databinder.dispatch/dispatch-json4s-native_2.10, ...
> cleanCache "net.databinder.dispatch" % "dispatch-json4s"
[success] Total time: 0 s, completed Aug 21, 2013 9:47:26 PM

To clean all artifacts from the organization "net.databinder.dispatch" that are cached.

> show cleanCacheFiles "net.databinder.dispatch"
[info] ArrayBuffer(~/.ivy2/cache/net.databinder.dispatch, ...
> cleanCache "net.databinder.dispatch"
[success] Total time: 1 s, completed Aug 21, 2013 9:49:04 PM

To clean all artifacts from the cache:

> show cleanCacheFiles *
[info] ArrayBuffer(~/.ivy2/cache, ~/.ivy2/cache/--compile-internal.xml ...
> cleanCache *
[success] Total time: 95 s, completed Aug 21, 2013 9:51:17 PM

The arguments work the same for cleanLocalFiles and cleanLocal.


MIT License. It's already in the license, but THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. Seriously, check what you're about to delete, and use it at your own risk.