name: clojure-symbols
description: Find and edit Clojure symbols using clj-kondo and REPL introspection. Use when finding Clojure function definitions, var usages, namespace contents, renaming Clojure symbols, replacing function bodies, or working with .clj/.cljc/.cljs files.
allowed-tools: Bash, Read, Edit, Task

Clojure Symbols Skill

Use clj-kondo for static analysis and clj-nrepl-eval for REPL introspection to find Clojure symbols.

For non-Clojure languages, use the code-symbols skill instead.

Prerequisites

clj-kondo

# Arch Linux
sudo pacman -S clj-kondo

# Homebrew
brew install borkdude/brew/clj-kondo

# Script
curl -sLO https://raw.githubusercontent.com/clj-kondo/clj-kondo/master/script/install-clj-kondo
chmod +x install-clj-kondo && ./install-clj-kondo

clj-nrepl-eval

Discover running nREPL servers:

clj-nrepl-eval --discover-ports

Quick Reference

Core clj-kondo Commands

Note: JSON keys use hyphens (e.g., var-definitions), so use bracket notation in jq.

Find Symbol Definition

clj-kondo --lint src components bases \
  --config '{:output {:format :json}, :analysis {:var-definitions true}}' \
  | jq '.analysis["var-definitions"][] | select(.name == "my-function")'

Find Symbol Usages

clj-kondo --lint src components bases \
  --config '{:output {:format :json}, :analysis {:var-usages true}}' \
  | jq '.analysis["var-usages"][] | select(.name == "my-function")'

List Symbols in File

clj-kondo --lint path/to/file.clj \
  --config '{:output {:format :json}, :analysis {:var-definitions true}}' \
  | jq '.analysis["var-definitions"]'

Output Fields

var-definitions:
- filename, row, col, end-row, end-col - Location
- ns, name - Identity
- defined-by - Defining form (e.g., clojure.core/defn)
- fixed-arities, doc, private

var-usages:
- from, to - Source and target namespaces
- name, arity - Symbol name and call arity
- from-var - Containing function
- row, col - Location

Core REPL Commands

# Get var metadata
clj-nrepl-eval -p PORT "(meta #'my.namespace/my-function)"

# Get source code
clj-nrepl-eval -p PORT "(clojure.repl/source my-function)"

# List namespace contents
clj-nrepl-eval -p PORT "(dir my.namespace)"

# Search by pattern
clj-nrepl-eval -p PORT "(clojure.repl/apropos \"pattern\")"

Common Workflow

Find Definition and All Usages

# Find definition
clj-kondo --lint . \
  --config '{:output {:format :json}, :analysis {:var-definitions true}}' \
  | jq '.analysis["var-definitions"][] | select(.name == "target-fn") | {ns, name, filename, row}'

# Find all usages
clj-kondo --lint . \
  --config '{:output {:format :json}, :analysis {:var-usages true}}' \
  | jq '.analysis["var-usages"][] | select(.name == "target-fn") | {from, "from-var", filename, row}'

Find Usages of a Namespace

clj-kondo --lint bases components \
  --config '{:output {:format :json}, :analysis {:var-usages true}}' \
  | jq '.analysis["var-usages"][] | select(.to == "my.namespace") | {from, name, filename, row}'

Additional References

• clj-kondo details: See references/kondo.md for full analysis options
• REPL introspection: See references/repl.md for REPL commands
• Editing/renaming: See references/editing.md for rename workflows