add section on shadow cljs to readme

Author: Bruce Hauman

PROJECT_SUMMARY.md

@@ -1,15 +1,9 @@
 # Clojure MCP Project Summary
 
-## Project Status
-
-**⚠️ Alpha Software** - This project is in early development and rapidly evolving. While invaluable for Clojure development workflows, expect breaking changes, rough edges, and incomplete documentation. Community contributions are actively welcomed for bug reports, feature suggestions, documentation improvements, and code contributions.
-
 ## Project Overview
 
 Clojure MCP is a Model Context Protocol (MCP) server that enables AI assistants (like Claude) to interact directly with a Clojure REPL. It provides a collaborative, REPL-driven development workflow between humans and LLMs. The core philosophy is "tiny steps with high quality rich feedback" for effective development.
 
-**Recent Major Refactoring**: The project has been refactored to separate the core MCP API from its consumption, enabling easier customization and reuse. The new pattern uses factory functions (`make-tools`, `make-prompts`, `make-resources`) and a single entry point (`core/build-and-start-mcp-server`) for creating custom MCP servers.
-
 The project allows AI assistants to:
 - Evaluate Clojure code and see immediate results
 - Incrementally develop solutions with step-by-step verification

README.md

@@ -371,6 +371,67 @@ If you continue to have issues, consider consulting with AI assistants (Claude,
 See the [Wiki](https://github.com/bhauman/clojure-mcp/wiki) for
 information on setting up other MCP clients.
 
+## Working with ClojureScript (shadow-cljs)
+
+ClojureMCP works seamlessly with [shadow-cljs](https://github.com/thheller/shadow-cljs) for ClojureScript development. Here's how to set it up:
+
+### Quick Start
+
+1. **Start your shadow-cljs server** with an nREPL port:
+   ```bash
+   # Start shadow-cljs (it will use port 9000 by default, or configure in shadow-cljs.edn)
+   npx shadow-cljs watch app
+   ```
+
+2. **Configure Claude Desktop or other client** to connect to the the shadow-cljs nREPL port:
+
+   ```
+   {
+    "mcpServers": {
+        "clojure-mcp": {
+            "command": "/bin/sh",
+            "args": [
+                "-c",
+                "PATH=/opt/homebrew/bin:$PATH && clojure -X:mcp :port 9000"
+            ]
+        }
+     }
+   }
+   ```
+
+OR change the shadow port to 7888 (or whatever port you have configured) and leave your client config as is.
+   
+
+3. **Switch to ClojureScript REPL** in Claude Desktop:
+   
+   Once Claude Desktop is connected, prompt Claude to evaluate:
+   ```clojure
+   (shadow/repl :app)
+   ```
+   
+   Replace `:app` with your actual build ID from `shadow-cljs.edn`.
+
+4. **All set!** Now all `clojure_eval` calls will be routed to your ClojureScript REPL, allowing you to:
+   - Evaluate ClojureScript code
+   - Interact with your running application
+   - Use all ClojureMCP tools for ClojureScript development
+
+### Switching Back to Clojure
+
+To exit the ClojureScript REPL and return to Clojure, have Claude evaluate:
+```clojure
+:cljs/quit
+```
+
+### Tips for shadow-cljs Development
+
+- **Build Selection**: Use the appropriate build ID (`:app`, `:main`, `:test`, etc.) based on your `shadow-cljs.edn` configuration
+- **Hot Reload**: shadow-cljs hot reload continues to work normally while using ClojureMCP
+- **Browser Connection**: Ensure your browser is connected to shadow-cljs for browser-targeted builds
+- **Node.js Builds**: Works equally well with Node.js targeted builds
+
+This integration gives you the full power of ClojureMCP's REPL-driven development workflow for ClojureScript projects!
+
 ## Starting a new conversation
 
 Once everything is set up I'd suggest starting a new chat in Claude.

src/clojure_mcp/tools/unified_read_file/tool.clj

@@ -23,6 +23,7 @@
   ([nrepl-client-atom {:keys [max-lines max-line-length]
                        :or {max-lines 2000
                             max-line-length 1000}}]
+   ;; TODO this is naive and is a problem for files that are just one line
    {:tool-type :unified-read-file
     :nrepl-client-atom nrepl-client-atom
     :max-lines max-lines