Skip to content
Back to search

claude-config-editor

Claude Config Editor is a lightweight web tool that helps you clean and optimize your Claude Code/Desktop config files (.claude.json). Analyze project sizes, bulk delete chat histories, export data for backup, manage servers visually, and speed up Claude—all locally, with auto-backup, no dependencies, and cross-platform support.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gagarinyury--claude-config-editor/badge.svg)](/listings/gagarinyury--claude-config-editor)

HTML

<a href="/listings/gagarinyury--claude-config-editor"><img src="/api/listings/gagarinyury--claude-config-editor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Three commands. Zero dependencies. Zero configuration.**

git clone https://github.com/gagarinyury/claude-config-editor.git
cd claude-config-editor
python3 server.py

**That's it.** Opens at `http://localhost:8765`.

What Happens Next

1. **Tool auto-detects** your configs (Claude Code + Claude Desktop) 2. **You select** which one to edit 3. **30 seconds later** your config is clean and fast

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 340 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🚀 Claude Config Editor
  2. <p align="center">
  3. <img src="https://img.shields.io/badge/Your%20.claude.json%20is-BLOATED-red?style=for-the-badge" alt="Bloated">
  4. <img src="https://img.shields.io/badge/This%20fixes%20it-IN%2030%20SECONDS-green?style=for-the-badge" alt="Fixed">
  5. </p>
  6. <h3 align="center">⚡ The missing GUI for Claude configurations ⚡</h3>
  7. <p align="center">
  8. <strong>Your Claude config is probably 10+ MB.</strong><br>
  9. <strong>Mine was 17 MB.</strong> Now it's <strong>732 KB</strong>.<br>
  10. <strong>This tool did it in 30 seconds.</strong>
  11. </p>
  12. <p align="center">
  13. <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
  14. <img src="https://img.shields.io/badge/python-3.7+-blue.svg" alt="Python">
  15. <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg" alt="Platform">
  16. <img src="https://img.shields.io/badge/dependencies-ZERO-brightgreen.svg" alt="Zero Dependencies">
  17. </p>
  18. ---
  19. ## 🔥 The Problem
  20. **Claude Code stores EVERY conversation from EVERY project** in a single JSON file.
  21. After a few weeks of use:
  22. - 📁 87 projects with full chat histories
  23. - 💾 **17 MB** of JSON (yes, really)
  24. - 🐌 **Slow startup times** (Claude has to parse that mess)
  25. - 🤷 **No easy way to clean it up** (manual JSON editing? no thanks)
  26. **Sound familiar?**
  27. ## ✅ The Solution
  28. A beautiful web interface to:
  29. - 🔍 **See what's eating your disk** (sorted by size)
  30. - 🗑️ **Delete old projects in bulk** (top 10 biggest = 90% of bloat)
  31. - 💾 **Export before deleting** (keep important conversations)
  32. - 🔌 **Manage MCP servers** (no more JSON editing)
  33. - 🛡️ **Auto-backup everything** (undo button for real life)
  34. **Works with both Claude Code AND Claude Desktop.**
  35. ---
  36. ## 🎯 Why People Star This Repo
  37. > "My .claude.json was 23 MB. Deleted 50 old projects. Now it's 1.8 MB. Claude Code starts instantly now." - *Actual result*
  38. > "Finally! I can see my MCP servers without opening VSCode." - *Reddit user*
  39. > "I didn't even know this was a problem until I ran this tool." - *HN comment*
  40. **Translation:** This tool solves a problem you didn't know you had, in 30 seconds, with zero risk.
  41. ---
  42. ## 📸 Screenshots
  43. ### Overview Dashboard
  44. ![Overview](screenshots/overview.png)
  45. *Quick stats and health analysis at a glance*
  46. ### Project History Manager
  47. ![Project History](screenshots/project-history.png)
  48. *See which projects are eating disk space, export or delete with one click*
  49. ### MCP Servers
  50. ![MCP Servers](screenshots/mcp-servers.png)
  51. *Visual management of MCP server configurations*
  52. ---
  53. ## 🚄 Quick Start
  54. **Three commands. Zero dependencies. Zero configuration.**
  55. ```bash
  56. git clone https://github.com/gagarinyury/claude-config-editor.git
  57. cd claude-config-editor
  58. python3 server.py
  59. ```
  60. **That's it.** Opens at `http://localhost:8765`.
  61. ### What Happens Next
  62. 1. **Tool auto-detects** your configs (Claude Code + Claude Desktop)
  63. 2. **You select** which one to edit
  64. 3. **30 seconds later** your config is clean and fast
  65. ---
  66. ## ✨ Features That Make You Go "Finally!"
  67. ### 📊 Smart Analytics
  68. See **exactly** what's taking up space:
  69. - Config size (before/after)
  70. - Projects ranked by size (biggest first)
  71. - Instant health check ("Your config is bloated AF")
  72. ### 📁 Project History Manager
  73. The killer feature:
  74. - **Export individual project histories** before deletion (download as JSON)
  75. - **Bulk delete old projects** (select top 10 = 90% space saved)
  76. - **Search & filter** (find that old client project from 6 months ago)
  77. - **Sort by size/name/messages** (find the bloat faster)
  78. ### 🔌 MCP Server Management
  79. Because editing JSON manually is for masochists:
  80. - **Visual list** of all MCP servers
  81. - **See command, args, env, working directory** at a glance
  82. - **Add/remove servers** with one click
  83. - **No more typos** in JSON (you know what I'm talking about)
  84. ### 🎨 Beautiful Interface
  85. - Dark theme (because your eyes matter)
  86. - Real-time updates (see changes as you make them)
  87. - Responsive (works on your tiny laptop screen)
  88. - **No installation required** (Python stdlib only)
  89. ### 🔒 Safety First
  90. - **Auto-backup before every save** (undo button for real life)
  91. - **Non-destructive** (only changes what you tell it to)
  92. - **Local-only** (zero network requests, zero data collection)
  93. - **Preview before save** (see what you're about to do)
  94. ---
  95. ## 💡 Real-World Use Cases
  96. ### "My Claude Code is slow"
  97. → Your config is probably huge. Click "Top 10 Largest", delete, save. Done in 30 seconds.
  98. ### "I want to backup my conversations"
  99. → Go to Project History, click "💾 Export" on any project. Downloads JSON. Keep forever.
  100. ### "I don't know which MCP servers I have"
  101. → Go to MCP Servers tab. See everything. No more `cat ~/.claude.json | grep mcpServers`.
  102. ### "I messed up my config"
  103. → Restore from `.claude.backup.json` (created automatically before every save).
  104. ### "I want to share my setup"
  105. → Export your config, share the JSON. Or just share this tool.
  106. ---
  107. ## 📖 How It Works (30 Second Tutorial)
  108. ### Clean Up Project History
  109. ```
  110. 1. Open tool → Go to "Project History"
  111. 2. Click "Top 10 Largest" (selects 90% of bloat)
  112. 3. Review → Click "Delete Selected"
  113. 4. Click "💾 Save Changes"
  114. ```
  115. **Result:** 17 MB → 732 KB (actual result from my config)
  116. ### Export Before Delete
  117. ```
  118. 1. Find project in list
  119. 2. Click "💾 Export" (downloads JSON)
  120. 3. Now safe to delete (you have a backup)
  121. ```
  122. ### Manage MCP Servers
  123. ```
  124. View: See all servers, their commands, args, env
  125. Add: Click "+ Add Server" → Enter name & command → Save
  126. Remove: Find server card → Click "Delete" → Save
  127. ```
  128. ---
  129. ## 🛡️ Safety & Trust
  130. - ✅ **Auto-backup** before every save (`.claude.backup.json`)
  131. - ✅ **Open source** (read the code, it's 300 lines)
  132. - ✅ **No analytics** (zero tracking, zero telemetry)
  133. - ✅ **Local-only** (runs on `localhost:8765`, no internet required)
  134. - ✅ **Non-destructive** (only modifies what you explicitly delete)
  135. **Worst case:** Restore from `.claude.backup.json`. **Best case:** Your Claude is fast again.
  136. ---
  137. ## 🔧 Technical Details
  138. ### Supported Configs
  139. | Config | Path | Auto-Detect |
  140. |--------|------|-------------|
  141. | Claude Code (macOS/Linux) | `~/.claude.json` | ✅ |
  142. | Claude Code (Windows) | `%USERPROFILE%\.claude.json` | ✅ |
  143. | Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` | ✅ |
  144. | Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` | ✅ |
  145. | Claude Desktop (Linux) | `~/.config/Claude/claude_desktop_config.json` | ✅ |
  146. ### Requirements
  147. - **Python 3.7+** (no pip install, no virtualenv, just works)
  148. - **Claude Code** or **Claude Desktop** (obviously)
  149. ### How It Actually Works
  150. 1. Starts HTTP server on port 8765
  151. 2. Loads config via REST API (`/api/config`)
  152. 3. Web UI makes changes in memory
  153. 4. Click "Save" → writes to disk (with backup)
  154. 5. Restart Claude → changes take effect
  155. **Source:** 300 lines of Python + 700 lines of HTML/CSS/JS. No frameworks. No build step. Just works.
  156. ---
  157. ## 🎓 FAQ (Questions You're About to Ask)
  158. **Q: Will this break my Claude setup?**
  159. A: No. Automatic backups + only changes what you delete. Worst case: restore from `.claude.backup.json`.
  160. **Q: Why is my config so big?**
  161. A: Claude stores EVERY message from EVERY project. 100 projects × 50 messages × 1 KB = 5 MB. Add paste content and it balloons to 10-20 MB.
  162. **Q: What happens to my conversations?**
  163. A: Project history = conversation history. Deleting a project = deleting its chat history. **Use "💾 Export" first if you want to keep it.**
  164. **Q: Is my data sent anywhere?**
  165. A: Nope. Runs on `localhost:8765`. Zero network requests. Check the code if you don't believe me.
  166. **Q: Can I undo a delete?**
  167. A: Before save? Yes (just refresh). After save? Restore from `.claude.backup.json` (created automatically).
  168. **Q: Why not just edit the JSON manually?**
  169. A: You could. Or you could use this and finish in 30 seconds instead of 30 minutes of JSON hell.
  170. **Q: Does this work with Claude Desktop?**
  171. A: Yes! Auto-detects both Claude Code (`.claude.json`) and Claude Desktop (`claude_desktop_config.json`).
  172. **Q: Can I run this on Windows?**
  173. A: Yes! Python is cross-platform. Works on macOS, Linux, Windows.
  174. ---
  175. ## 🤝 Contributing
  176. **Found a bug?** Open an issue.
  177. **Have an idea?** Open an issue.
  178. **Want to add a feature?** Fork + PR.
  179. ```bash
  180. git clone https://github.com/gagarinyury/claude-config-editor.git
  181. cd claude-config-editor
  182. # Make your changes
  183. git commit -am "Add awesome feature"
  184. git push origin main
  185. # Open PR
  186. ```
  187. **Code style:** Keep it simple. This is a tool, not a framework.
  188. ---
  189. ## 📜 License
  190. MIT License - do whatever you want with this code.
  191. ---
  192. ## 🙏 Origin Story
  193. I built this because:
  194. 1. My Claude Code was **slow as hell**
  195. 2. I checked `.claude.json` → **17 MB** 😱
  196. 3. I opened it → **87 projects** with full chat histories
  197. 4. I tried to clean it manually → **JSON hell**
  198. 5. I built this tool → **30 seconds later, 732 KB** ✨
  199. **If this saved you time, star the repo! ⭐**
  200. It helps others discover the tool and validates my late-night coding session.
  201. ---
  202. ## 🗺️ Roadmap
  203. - [ ] Search/filter in Raw JSON view
  204. - [ ] Edit MCP server parameters inline (args, env, cwd)
  205. - [ ] Import project history from JSON
  206. - [ ] Config diff viewer (before/after)
  207. - [ ] Automatic cleanup suggestions (AI-powered?)
  208. - [ ] Export config as shareable template
  209. **Got ideas?** Open an issue!
  210. ---
  211. ## 🌟 Star History
  212. If you found this useful, **star the repo**! It helps others discover it.
  213. <p align="center">
  214. <a href="https://star-history.com/#gagarinyury/claude-config-editor&Date">
  215. <img src="https://api.star-history.com/svg?repos=gagarinyury/claude-config-editor&type=Date" alt="Star History Chart">
  216. </a>
  217. </p>
  218. ---
  219. ## 💬 Support
  220. - 🐛 **Bugs:** [Open an issue](https://github.com/gagarinyury/claude-config-editor/issues)
  221. - 💡 **Ideas:** [Open an issue](https://github.com/gagarinyury/claude-config-editor/issues)
  222. - 💬 **Questions:** [Discussions](https://github.com/gagarinyury/claude-config-editor/discussions)
  223. - ⭐ **Show love:** Star the repo!
  224. ---
  225. <p align="center">
  226. <strong>Made with ❤️ and Claude Code</strong><br>
  227. <sub>(This tool was built using Claude Code. Meta, I know.)</sub>
  228. </p>
  229. <p align="center">
  230. <strong>If this saved you time, <a href="https://github.com/gagarinyury/claude-config-editor">⭐ star the repo</a>!</strong><br>
  231. <sub>It takes 2 seconds and makes my day.</sub>
  232. </p>
  233. ---
  234. <p align="center">
  235. <sub>P.S. Your config is probably bloated right now. Go check. I'll wait.</sub>
  236. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.