anchor.diff:  
   [source,shell]
   ----
  -clj -T:deps install-tool io.github.clojure/tools.deps.graph '{:git/tag "tools.deps.graph-1.0.56"}' :as deps-graph
  -----
  +clj -Ttools install io.github.clojure/tools.deps.graph '{:git/tag "v1.0.56"}' :as deps-graph
  +----
  +
  +Note that git deps can be fully described at tool installation time by using only a git lib name (which will be used to form a git url by convention), and a git tag.
  +
  +To list all installed tools:
  +
  +[source,shell]
  +----
  +clj -Ttools list
  +----
  +
  +To remove an installed tool:
  +
  +[source,shell]
  +----
  +clj -Ttools remove :tool name
  +----
  +
  +Other functions will likely be added in the future.
   
   === Tool usage
   
  -Tools can publish a `usage.edn` file that declares default configuration. The usage file will be obtained and cached as part of tool installation and used to resolve the function to be executed (and possibly other uses in the future).
  -
  -The `usage.edn` file is an edn map with the following keys:
  -
  -* `:exec` - the value is a subset of the alias arguments available in a deps.edn alias:
  -** `:ns-default`
  -** `:ns-aliases`
  -
  -For example, the tools.deps.graph tool might publish the following usage.edn:
  -
  -[source,clojure]
  -----
  -{:exec
  +Tools may include a top-level key `:deps/usage` in their deps.edn file to publish how the tool can be used with respect to namespace context. The value is a map which may have the following keys that are the same as their usage in deps.edn aliases:
  +
  +* `:ns-default` - a lib symbol indicating the default namespace when resolving functions
  +* `:ns-aliases` - a map of alias to lib symbol
  +
  +For example, the tools.deps.graph tool can publish the following usage in deps.edn:
  +
  +[source,clojure]
  +----
  +{:deps/usage
    {:ns-default clojure.tools.deps.graph}}
   ----
   
  -The usage.edn file is read from the `:paths` of a git lib project or from the root of the maven artifact jar.
  -
  -=== Invoke tool by name
  +=== Invoke a tool by name
   
   Once you've installed a named tool, you can invoke it with `-T` using just the tool name.
   
  
positive.code: clj -Ttool f args...
  ----
  
  The function will be resolved using the `:ns-default` and `:ns-aliases` found in the `usage.edn`.
  
  For example, for the tools.deps.graph tool declared above, it can be invoked as follows:
  
  
negative.code: 
  When running a tool, the project's `:deps` and `:paths` are not used. The function is invoked with a map in the same way as -X execution, built from :exec-args if found in aliases and key/vals provided on the command line.
  
  Tools are installed and referenced by a simpler local name, instead of via an alias. See <<deps_and_cli#tool_install,tool installation>> for more details.
  
  = Operation
  
  