{"id":32579530,"url":"https://github.com/gagarinyury/claude-config-editor","last_synced_at":"2026-03-04T14:31:13.585Z","repository":{"id":321203261,"uuid":"1084913003","full_name":"gagarinyury/claude-config-editor","owner":"gagarinyury","description":"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.","archived":false,"fork":false,"pushed_at":"2025-10-28T11:29:15.000Z","size":20,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-28T12:25:35.876Z","etag":null,"topics":["claude","claude-ai","claude-code","claude-desktop","cross-platform","lightweight","mcp-server","mcp-servers","no-dependencies","python"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gagarinyury.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-28T10:36:33.000Z","updated_at":"2025-10-28T12:10:56.000Z","dependencies_parsed_at":"2025-10-28T12:25:37.076Z","dependency_job_id":"2d8f8e43-da8b-4402-859e-b2f373d59832","html_url":"https://github.com/gagarinyury/claude-config-editor","commit_stats":null,"previous_names":["gagarinyury/claude-config-editor"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gagarinyury/claude-config-editor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gagarinyury%2Fclaude-config-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gagarinyury%2Fclaude-config-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gagarinyury%2Fclaude-config-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gagarinyury%2Fclaude-config-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gagarinyury","download_url":"https://codeload.github.com/gagarinyury/claude-config-editor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gagarinyury%2Fclaude-config-editor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30083738,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T13:22:36.021Z","status":"ssl_error","status_checked_at":"2026-03-04T13:20:45.750Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","claude-ai","claude-code","claude-desktop","cross-platform","lightweight","mcp-server","mcp-servers","no-dependencies","python"],"created_at":"2025-10-29T15:27:14.067Z","updated_at":"2026-03-04T14:31:13.346Z","avatar_url":"https://github.com/gagarinyury.png","language":"HTML","funding_links":[],"categories":["📚 Projects (1974 total)","Tools \u0026 Utilities"],"sub_categories":["MCP Servers"],"readme":"# 🚀 Claude Config Editor\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Your%20.claude.json%20is-BLOATED-red?style=for-the-badge\" alt=\"Bloated\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/This%20fixes%20it-IN%2030%20SECONDS-green?style=for-the-badge\" alt=\"Fixed\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e⚡ The missing GUI for Claude configurations ⚡\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eYour Claude config is probably 10+ MB.\u003c/strong\u003e\u003cbr\u003e\n  \u003cstrong\u003eMine was 17 MB.\u003c/strong\u003e Now it's \u003cstrong\u003e732 KB\u003c/strong\u003e.\u003cbr\u003e\n  \u003cstrong\u003eThis tool did it in 30 seconds.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.7+-blue.svg\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg\" alt=\"Platform\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/dependencies-ZERO-brightgreen.svg\" alt=\"Zero Dependencies\"\u003e\n\u003c/p\u003e\n\n---\n\n## 🔥 The Problem\n\n**Claude Code stores EVERY conversation from EVERY project** in a single JSON file.\n\nAfter a few weeks of use:\n- 📁 87 projects with full chat histories\n- 💾 **17 MB** of JSON (yes, really)\n- 🐌 **Slow startup times** (Claude has to parse that mess)\n- 🤷 **No easy way to clean it up** (manual JSON editing? no thanks)\n\n**Sound familiar?**\n\n## ✅ The Solution\n\nA beautiful web interface to:\n- 🔍 **See what's eating your disk** (sorted by size)\n- 🗑️ **Delete old projects in bulk** (top 10 biggest = 90% of bloat)\n- 💾 **Export before deleting** (keep important conversations)\n- 🔌 **Manage MCP servers** (no more JSON editing)\n- 🛡️ **Auto-backup everything** (undo button for real life)\n\n**Works with both Claude Code AND Claude Desktop.**\n\n---\n\n## 🎯 Why People Star This Repo\n\n\u003e \"My .claude.json was 23 MB. Deleted 50 old projects. Now it's 1.8 MB. Claude Code starts instantly now.\" - *Actual result*\n\n\u003e \"Finally! I can see my MCP servers without opening VSCode.\" - *Reddit user*\n\n\u003e \"I didn't even know this was a problem until I ran this tool.\" - *HN comment*\n\n**Translation:** This tool solves a problem you didn't know you had, in 30 seconds, with zero risk.\n\n---\n\n## 📸 Screenshots\n\n### Overview Dashboard\n![Overview](screenshots/overview.png)\n*Quick stats and health analysis at a glance*\n\n### Project History Manager\n![Project History](screenshots/project-history.png)\n*See which projects are eating disk space, export or delete with one click*\n\n### MCP Servers\n![MCP Servers](screenshots/mcp-servers.png)\n*Visual management of MCP server configurations*\n\n---\n\n## 🚄 Quick Start\n\n**Three commands. Zero dependencies. Zero configuration.**\n\n```bash\ngit clone https://github.com/gagarinyury/claude-config-editor.git\ncd claude-config-editor\npython3 server.py\n```\n\n**That's it.** Opens at `http://localhost:8765`.\n\n### What Happens Next\n\n1. **Tool auto-detects** your configs (Claude Code + Claude Desktop)\n2. **You select** which one to edit\n3. **30 seconds later** your config is clean and fast\n\n---\n\n## ✨ Features That Make You Go \"Finally!\"\n\n### 📊 Smart Analytics\nSee **exactly** what's taking up space:\n- Config size (before/after)\n- Projects ranked by size (biggest first)\n- Instant health check (\"Your config is bloated AF\")\n\n### 📁 Project History Manager\nThe killer feature:\n- **Export individual project histories** before deletion (download as JSON)\n- **Bulk delete old projects** (select top 10 = 90% space saved)\n- **Search \u0026 filter** (find that old client project from 6 months ago)\n- **Sort by size/name/messages** (find the bloat faster)\n\n### 🔌 MCP Server Management\nBecause editing JSON manually is for masochists:\n- **Visual list** of all MCP servers\n- **See command, args, env, working directory** at a glance\n- **Add/remove servers** with one click\n- **No more typos** in JSON (you know what I'm talking about)\n\n### 🎨 Beautiful Interface\n- Dark theme (because your eyes matter)\n- Real-time updates (see changes as you make them)\n- Responsive (works on your tiny laptop screen)\n- **No installation required** (Python stdlib only)\n\n### 🔒 Safety First\n- **Auto-backup before every save** (undo button for real life)\n- **Non-destructive** (only changes what you tell it to)\n- **Local-only** (zero network requests, zero data collection)\n- **Preview before save** (see what you're about to do)\n\n---\n\n## 💡 Real-World Use Cases\n\n### \"My Claude Code is slow\"\n→ Your config is probably huge. Click \"Top 10 Largest\", delete, save. Done in 30 seconds.\n\n### \"I want to backup my conversations\"\n→ Go to Project History, click \"💾 Export\" on any project. Downloads JSON. Keep forever.\n\n### \"I don't know which MCP servers I have\"\n→ Go to MCP Servers tab. See everything. No more `cat ~/.claude.json | grep mcpServers`.\n\n### \"I messed up my config\"\n→ Restore from `.claude.backup.json` (created automatically before every save).\n\n### \"I want to share my setup\"\n→ Export your config, share the JSON. Or just share this tool.\n\n---\n\n## 📖 How It Works (30 Second Tutorial)\n\n### Clean Up Project History\n\n```\n1. Open tool → Go to \"Project History\"\n2. Click \"Top 10 Largest\" (selects 90% of bloat)\n3. Review → Click \"Delete Selected\"\n4. Click \"💾 Save Changes\"\n```\n\n**Result:** 17 MB → 732 KB (actual result from my config)\n\n### Export Before Delete\n\n```\n1. Find project in list\n2. Click \"💾 Export\" (downloads JSON)\n3. Now safe to delete (you have a backup)\n```\n\n### Manage MCP Servers\n\n```\nView:   See all servers, their commands, args, env\nAdd:    Click \"+ Add Server\" → Enter name \u0026 command → Save\nRemove: Find server card → Click \"Delete\" → Save\n```\n\n---\n\n## 🛡️ Safety \u0026 Trust\n\n- ✅ **Auto-backup** before every save (`.claude.backup.json`)\n- ✅ **Open source** (read the code, it's 300 lines)\n- ✅ **No analytics** (zero tracking, zero telemetry)\n- ✅ **Local-only** (runs on `localhost:8765`, no internet required)\n- ✅ **Non-destructive** (only modifies what you explicitly delete)\n\n**Worst case:** Restore from `.claude.backup.json`. **Best case:** Your Claude is fast again.\n\n---\n\n## 🔧 Technical Details\n\n### Supported Configs\n\n| Config | Path | Auto-Detect |\n|--------|------|-------------|\n| Claude Code (macOS/Linux) | `~/.claude.json` | ✅ |\n| Claude Code (Windows) | `%USERPROFILE%\\.claude.json` | ✅ |\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` | ✅ |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` | ✅ |\n| Claude Desktop (Linux) | `~/.config/Claude/claude_desktop_config.json` | ✅ |\n\n### Requirements\n- **Python 3.7+** (no pip install, no virtualenv, just works)\n- **Claude Code** or **Claude Desktop** (obviously)\n\n### How It Actually Works\n1. Starts HTTP server on port 8765\n2. Loads config via REST API (`/api/config`)\n3. Web UI makes changes in memory\n4. Click \"Save\" → writes to disk (with backup)\n5. Restart Claude → changes take effect\n\n**Source:** 300 lines of Python + 700 lines of HTML/CSS/JS. No frameworks. No build step. Just works.\n\n---\n\n## 🎓 FAQ (Questions You're About to Ask)\n\n**Q: Will this break my Claude setup?**\nA: No. Automatic backups + only changes what you delete. Worst case: restore from `.claude.backup.json`.\n\n**Q: Why is my config so big?**\nA: 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.\n\n**Q: What happens to my conversations?**\nA: Project history = conversation history. Deleting a project = deleting its chat history. **Use \"💾 Export\" first if you want to keep it.**\n\n**Q: Is my data sent anywhere?**\nA: Nope. Runs on `localhost:8765`. Zero network requests. Check the code if you don't believe me.\n\n**Q: Can I undo a delete?**\nA: Before save? Yes (just refresh). After save? Restore from `.claude.backup.json` (created automatically).\n\n**Q: Why not just edit the JSON manually?**\nA: You could. Or you could use this and finish in 30 seconds instead of 30 minutes of JSON hell.\n\n**Q: Does this work with Claude Desktop?**\nA: Yes! Auto-detects both Claude Code (`.claude.json`) and Claude Desktop (`claude_desktop_config.json`).\n\n**Q: Can I run this on Windows?**\nA: Yes! Python is cross-platform. Works on macOS, Linux, Windows.\n\n---\n\n## 🤝 Contributing\n\n**Found a bug?** Open an issue.\n**Have an idea?** Open an issue.\n**Want to add a feature?** Fork + PR.\n\n```bash\ngit clone https://github.com/gagarinyury/claude-config-editor.git\ncd claude-config-editor\n# Make your changes\ngit commit -am \"Add awesome feature\"\ngit push origin main\n# Open PR\n```\n\n**Code style:** Keep it simple. This is a tool, not a framework.\n\n---\n\n## 📜 License\n\nMIT License - do whatever you want with this code.\n\n---\n\n## 🙏 Origin Story\n\nI built this because:\n\n1. My Claude Code was **slow as hell**\n2. I checked `.claude.json` → **17 MB** 😱\n3. I opened it → **87 projects** with full chat histories\n4. I tried to clean it manually → **JSON hell**\n5. I built this tool → **30 seconds later, 732 KB** ✨\n\n**If this saved you time, star the repo! ⭐**\n\nIt helps others discover the tool and validates my late-night coding session.\n\n---\n\n## 🗺️ Roadmap\n\n- [ ] Search/filter in Raw JSON view\n- [ ] Edit MCP server parameters inline (args, env, cwd)\n- [ ] Import project history from JSON\n- [ ] Config diff viewer (before/after)\n- [ ] Automatic cleanup suggestions (AI-powered?)\n- [ ] Export config as shareable template\n\n**Got ideas?** Open an issue!\n\n---\n\n## 🌟 Star History\n\nIf you found this useful, **star the repo**! It helps others discover it.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#gagarinyury/claude-config-editor\u0026Date\"\u003e\n    \u003cimg src=\"https://api.star-history.com/svg?repos=gagarinyury/claude-config-editor\u0026type=Date\" alt=\"Star History Chart\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 💬 Support\n\n- 🐛 **Bugs:** [Open an issue](https://github.com/gagarinyury/claude-config-editor/issues)\n- 💡 **Ideas:** [Open an issue](https://github.com/gagarinyury/claude-config-editor/issues)\n- 💬 **Questions:** [Discussions](https://github.com/gagarinyury/claude-config-editor/discussions)\n- ⭐ **Show love:** Star the repo!\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMade with ❤️ and Claude Code\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003e(This tool was built using Claude Code. Meta, I know.)\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eIf this saved you time, \u003ca href=\"https://github.com/gagarinyury/claude-config-editor\"\u003e⭐ star the repo\u003c/a\u003e!\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003eIt takes 2 seconds and makes my day.\u003c/sub\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eP.S. Your config is probably bloated right now. Go check. I'll wait.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgagarinyury%2Fclaude-config-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgagarinyury%2Fclaude-config-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgagarinyury%2Fclaude-config-editor/lists"}