AgentSkillsCN

Clojure Eval

Clojure Eval

SKILL.md

Clojure REPL Evaluation Skill

Evaluate Clojure code via nREPL using the clj-nrepl-eval command.

Capabilities

  • •Verify Clojure files compile and load correctly
  • •Test function behavior interactively
  • •Debug expressions in a persistent session
  • •Load and require namespaces with :reload
  • •Validate code changes before committing

Workflow

1. Discover nREPL Servers

bash
clj-nrepl-eval --discover-ports

Shows available nREPL servers (Clojure, Babashka, shadow-cljs, etc.).

2. Evaluate Code

bash
clj-nrepl-eval -p <PORT> "(+ 1 2 3)"

3. Require Namespaces

Always use :reload to pick up recent changes:

bash
clj-nrepl-eval -p <PORT> "(require '[ascolais.phandaal :as phandaal] :reload)"

Important Options

OptionDescription
-p, --port PORTnREPL port (required)
-t, --timeout MSTimeout in milliseconds (default: 120000)
-r, --reset-sessionClear all session state
-d, --discover-portsFind running nREPL servers

Session Persistence

Session state persists between evaluations. You can require a namespace in one call and use it in subsequent calls.

Best Practices

  1. •Use :reload when requiring namespaces to capture recent file changes
  2. •Pass code as arguments when possible for simple expressions
  3. •Use heredoc for complex multiline code to avoid shell escaping issues
  4. •Increase timeout for long-running operations with -t