Skip to content

Commit ba69c41

Browse files
author
Bruce Hauman
committed
Update README with clearer project status and recommendations
- Remove "Alpha Software - Work in Progress" warning - Add "IMPORTANT UPDATE" section with current status (Nov 2025) - Restructure recommendations into clear subsections - Provide clear guidance on when to use Claude Code + clojure-mcp-light vs full ClojureMCP - Add decision criteria for choosing between toolsets - Fix typos and improve clarity
1 parent 315f31c commit ba69c41

File tree

1 file changed

+27
-2
lines changed

1 file changed

+27
-2
lines changed

README.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,36 @@
11
# Clojure MCP: REPL-Driven Development with AI Assistance
22

3-
> **⚠️ Alpha Software - Work in Progress**
4-
53
Clojure MCP connects AI models to your Clojure development
64
environment, enabling a remarkable REPL-driven development experience
75
powered by large language models (LLMs).
86

7+
## IMPORTANT UPDATE
8+
9+
**Status Update (November 14 2025)**: Recent improvements in Claude Code with Sonnet 4.5 have significantly changed the landscape for AI-assisted Clojure development. This model makes far fewer editing errors and coding logic errors than previous models, reducing the need for specialized clj-rewrite-based editing tools and REPL validation that ClojureMCP was designed to provide.
10+
11+
**Recommended Starting Point**
12+
13+
**For new users**: I recommend starting with [Claude Code](https://www.claude.com/product/claude-code) paired with [clojure-mcp-light](https://github.com/bhauman/clojure-mcp-light), which provides:
14+
- Automatic correction of occasional delimiter errors
15+
- nREPL CLI connection script
16+
- Performance statistics tracking
17+
18+
This is my current daily driver and has significantly improved my productivity compared to using Claude Desktop with the full ClojureMCP toolset.
19+
20+
**When to Use Full ClojureMCP**
21+
22+
ClojureMCP remains valuable for:
23+
- **Other LLM models** - Models with weaker editing capabilities benefit from the advanced tooling
24+
- **Desktop environments** - Use with Claude Desktop to see visible tool execution chains and reasoning
25+
- **Custom assistants** - Building your own code assistance tools
26+
- **Complete control** - When you need the full suite of Clojure-aware tools
27+
- **Portable LLM tooling configuration** ClojureMCP provides a portable
28+
toolset include custom agents, prompts, etc that you can use with any LLM that supports MCP
29+
30+
**Future Direction**
31+
32+
I'll continue developing ClojureMCP, but will be using Claude Code with clojure-mcp-light for the development work itself. ClojureMCP remains the comprehensive toolkit for Clojure AI assistance across any LLM.
33+
934
## 🚀 Quick Overview
1035

1136
Clojure MCP transforms LLMs into:

0 commit comments

Comments
 (0)