@mcpware/claude-code-organizer 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "claude-code-organizer",
+  "version": "0.1.0",
+  "description": "Organize all your Claude Code memories, skills, MCP servers, and hooks — view by scope hierarchy, move between scopes via drag-and-drop",
+  "author": {
+    "name": "mcpware",
+    "url": "https://github.com/mcpware"
+  },
+  "homepage": "https://github.com/mcpware/claude-code-organizer",
+  "repository": "https://github.com/mcpware/claude-code-organizer",
+  "license": "MIT",
+  "keywords": [
+    "organizer",
+    "memory",
+    "skills",
+    "mcp",
+    "config",
+    "scope",
+    "dashboard"
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcpware
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PLAN.md

@@ -0,0 +1,243 @@
+# Claude Inventory Manager
+
+**A scope-aware inventory manager for Claude Code customizations — view, organize, and sync your memories, skills, MCP servers, hooks, commands, and plugins.**
+
+## Problem
+
+Claude Code customizations (memories, skills, MCP servers, hooks, etc.) are scattered across multiple directories with ugly encoded paths. Users don't know:
+- What customizations they have
+- Which scope each one applies to
+- Whether something is in the wrong scope
+- How parent-child scope inheritance works
+
+## Solution
+
+A lightweight web dashboard + MCP server that:
+1. Scans all Claude Code customizations
+2. Displays them in a scope-aware hierarchy
+3. Lets users drag-and-drop items between scopes
+4. Syncs changes to git for versioning
+
+## Competitive Landscape (researched 2026-03-18)
+
+### Direct Competitors
+
+| Tool | Type | Scope View | Move Between Scopes | Threat |
+|---|---|:---:|:---:|:---:|
+| [drewipson/claude-code-config](https://github.com/drewipson/claude-code-config) | VS Code ext (pre-release v0.1.2) | ✅ Tree view | ✅ Right-click move | ⚠️ Medium |
+| [conradBruchmann/claude-admin](https://github.com/conradBruchmann/claude-admin) | Web dashboard (v0.1.9, Feb 2026) | Partial | ❌ | Low |
+| [joeyism/claude-code-config](https://github.com/joeyism/claude-code-config) | TUI | MCP only | ✅ MCP only | Low |
+| [Claude Deck](https://claudedeck.org/) | Web dashboard (React+FastAPI) | ❌ | ❌ | Low |
+| [claude-code-backup](https://github.com/Ranteck/claude-code-backup) | Backup scripts | ❌ | ❌ | None |
+| [ocodista/claude-dashboard](https://github.com/ocodista/claude-dashboard) | Read-only HTML | ❌ | ❌ | None |
+
+### Key Competitor Analysis
+
+**drewipson/claude-code-config** — closest competitor:
+- VS Code extension with tree view of memories, skills, hooks, permissions
+- Right-click to move items between global and project scope
+- **Gaps vs us:** VS Code only (not standalone), no drag-and-drop, no MCP servers, no scope hierarchy visualization, pre-release quality, no web UI
+
+**conradBruchmann/claude-admin** — broadest feature set:
+- Web dashboard covering skills, memory, MCP, agents, plugins, sessions, analytics
+- Shipped Feb 20, 2026 — growing fast (33 commits, v0.1.9)
+- **Gaps vs us:** No scope hierarchy view, no move between scopes, no drag-and-drop. Config editor, not inventory manager
+
+### What Nobody Has Built (our lane)
+
+No existing tool combines all three:
+1. **Unified scope hierarchy** — all item types (memories, skills, MCP, hooks) organized by Global → workspace → project
+2. **Move between scopes** via drag-and-drop or modal UI
+3. **Standalone web dashboard** — not tied to VS Code or any IDE
+
+### Anthropic Official Stance (researched 2026-03-18)
+
+- `/config` is a per-scope settings toggle, NOT a cross-scope inventory
+- No changelog entries, planned issues, or blog posts mention config dashboard / inventory
+- Official plugin `claude-md-management` focuses on CLAUDE.md content quality, not scope management
+- 2026 Anthropic focus: plugins ecosystem, remote control, scheduled tasks, auto memory, 1M context
+- **Risk of Anthropic building this: LOW** — no signals in any channel
+
+**Our unique angles:**
+- Scope-aware hierarchy with drag-and-drop (nobody has this)
+- Zero dependencies (single Node.js file + SortableJS CDN)
+- Daily git versioning (track what changed over time)
+- Cross-machine diff and export/import
+- Standalone — works anywhere, not locked to VS Code
+
+## Target User
+
+Any Claude Code power user who has accumulated enough memories, skills, and configs that they need to organize and understand their setup.
+
+---
+
+## Architecture
+
+### What We Manage
+
+| Type | Has Sub-types | Has Scope | Can Move Scope | Storage |
+|---|---|---|---|---|
+| **Memory** | feedback / user / project / reference | Global, per-project | Yes — between memory folders | `.md` files with frontmatter |
+| **Skills** | No | Global (`~/.claude/skills/`), per-repo (`.claude/skills/`) | Yes — between skill folders | Folders with `SKILL.md` |
+| **MCP Servers** | No | Global (`.mcp.json`), workspace, per-repo | Yes — move JSON entry between `.mcp.json` files |
+| **Hooks** | By event type (Stop, PreToolUse, PostToolUse, etc.) | Global, per-project, per-repo | Yes — move between `settings.json` files |
+| **Commands** | No | Per-repo (`.claude/commands/`) | Yes — between command folders |
+| **Plugins** | No | Global | No — installed globally only |
+| **Config** | No | Global + per-project | No — locked, edit via Claude or manually |
+| **Plans** | No | Global (`~/.claude/plans/`) | No — ephemeral |
+| **Agents** | No | Per-repo (`.claude/agents/`) | Yes — between agent folders |
+| **CLAUDE.md** | No | Global + per-repo | No — locked, edit manually |
+
+### Scope Hierarchy
+
+```
+🌐 Global                         ← applies everywhere
+  ↳ 📂 AlltrueAi (workspace)      ← applies when cd ~/AlltrueAi/*
+      ↳ 📂 ai-security-control-plane (project)
+      ↳ 📂 ai-security-ui (project)
+      ↳ 📂 rule-processor (project)
+  ↳ 📂 MyGithub (project)         ← applies when cd ~/MyGithub
+  ↳ 📂 Documents (project)        ← applies when cd ~/Documents
+```
+
+Child scopes inherit parent scope's memories, skills, and MCP servers.
+
+### Move Safety Rules
+
+- Memory → only to other memory folders
+- Skill → only to other skill locations (global or per-repo)
+- MCP → only between `.mcp.json` files
+- Config/CLAUDE.md/Plans → locked, cannot move
+- Every drag-and-drop shows a confirmation modal before executing
+- Moves happen in real `~/.claude/` paths (not just the backup repo)
+
+### Tech Stack
+
+- **Server**: Single Node.js file (zero npm dependencies, built-in modules only)
+- **Client**: HTML + CSS + [SortableJS](https://github.com/SortableJS/Sortable) via CDN (13KB)
+- **Distribution**: MCP server + npm package (`npx @mcpware/claude-inventory`)
+- **Also works as**: standalone `localhost` dashboard
+
+### Platform Support
+
+| Platform | Status | Notes |
+|----------|:------:|-------|
+| **Ubuntu / Linux** | ✅ Supported | Primary development and testing platform |
+| **macOS** | ⚠️ Untested | `~/.claude/` path should work, needs verification |
+| **Windows** | ❌ Not yet | Path handling needs adaptation (`C:\Users\...\.claude\`) |
+| **WSL** | ⚠️ Untested | Should work like Linux, needs verification |
+
+Current limitation: developed and tested on Ubuntu only. macOS and Windows support planned for future release.
+
+**Cross-platform notes (researched 2026-03-18):**
+- macOS: `~/.claude/` same as Linux, `os.homedir()` works → should work out of the box
+- Windows: `%USERPROFILE%\.claude\`, but path encoding uses `--` for `:\` (known Claude Code bug [#14403](https://github.com/anthropics/claude-code/issues/14403))
+- `CLAUDE_CONFIG_DIR` env var can override config location — should check this first
+- `fs.rename` needs `EXDEV` fallback (copy+delete) for cross-filesystem moves
+
+---
+
+## Roadmap
+
+### MVP 1 — View + Move + Sync ✅ DONE (2026-03-18)
+- [x] UI mockup (see `mockup.html`)
+- [x] Node.js server that scans real `~/.claude/` directory
+- [x] Scope-aware hierarchy display (Global → projects → sub-projects)
+- [x] Categories: Memory, Skills, MCP Servers, Config, Hooks, Plugins, Plans
+- [x] SortableJS drag-and-drop between same-type scopes
+- [x] Confirmation modal on every move
+- [x] Move files in real `~/.claude/` paths
+- [x] "Open in Editor" button (VS Code deeplink)
+- [x] Search across all items
+- [x] Multi-select filter pills with counts
+- [x] Detail panel on click
+- [x] Move-to modal with scope tree + correct indentation
+- [x] Current scope indicator in move modal
+- [x] Auto-scroll during drag
+- [x] Locked items (config, plugins, plans) cannot be moved
+- [x] Generic — no hardcoded paths, works on any user's machine
+- [x] Frontend/backend separation (4 UI files, 3 backend files)
+- [ ] Daily git sync (`sync.sh` + cron) — already working separately
+- [ ] Export/import tarball
+
+### MVP 2 — Inline Edit + Polish
+- [ ] Click item → show full `.md` content in detail panel
+- [ ] Edit content inline, save back to file
+- [ ] Improve confirm modal design (show item icon, type, scope badges)
+- [ ] Add Commands management
+- [ ] Check `CLAUDE_CONFIG_DIR` env var for custom config paths
+- [ ] `fs.rename` EXDEV fallback (copy + delete)
+- [ ] Add Agents management
+
+### MVP 3 — Dashboard Stats + Polish
+- [ ] Stats panel (total counts, size, last modified)
+- [ ] Scope inheritance visualization
+- [ ] Cross-machine diff (compare two exports)
+- [ ] Config health/lint (detect conflicts, redundancies)
+- [ ] Dark mode toggle
+
+### MVP 4 — MCP + npm Distribution
+- [ ] Package as MCP server (`@mcpware/claude-inventory`)
+- [ ] MCP tools: `scan_setup`, `move_memory`, `list_memories`, `export_setup`
+- [ ] `npx @mcpware/claude-inventory` one-command start
+- [ ] Publish to npm (@mcpware org)
+- [ ] Register on Official MCP Registry
+- [ ] Submit to awesome-mcp-servers
+
+---
+
+## UI Design
+
+### Design Principles
+- Light theme, clean, minimal
+- Hierarchy: Scope headers (most prominent) > Category bars (medium) > Item rows (subtle)
+- All light backgrounds with dark text
+- Items indented under categories, categories indented under scopes
+- Same-type icons: all memories use 🧠, all skills use ⚡, all MCP use 🔌, all scopes use 📂
+
+### Current Mockup
+See `mockup.html` — interactive prototype with:
+- Collapsible scope/category sections
+- SortableJS drag-and-drop (memory↔memory, skill↔skill, mcp↔mcp only)
+- Drag confirmation modal
+- Detail panel on click
+- Search and filter pills
+- Scope inheritance indicators (`↳ Inherits 🌐 Global 📂 AlltrueAi`)
+
+### Color Palette
+```
+Background:     #fafbfc
+Surface:        #ffffff
+Border:         #e2e4ea
+Text primary:   #1e2028
+Text secondary: #5a5d6e
+Text muted:     #9598a8
+Accent:         #5b5fc7 (indigo)
+Accent light:   #ededfa
+Scope bg:       #f0f1f8
+Category bg:    #f6f7fb
+
+Tags:
+  Global:     bg #e8e9fa  text #5b5fc7
+  Workspace:  bg #fef0e4  text #c67a2e
+  Project:    bg #e4f6ec  text #2d8a56
+
+Badges:
+  feedback:   #e6960a
+  user:       #7c3aed
+  project:    #2563eb
+  reference:  #059669
+  skill:      #ea580c
+  mcp:        #d946a8
+  config:     #9ca3af
+```
+
+---
+
+## Research Sources
+
+- [Drag-and-drop research](../.claude/skills/claude-inventory/) — SortableJS recommended over raw HTML5 DnD
+- [Market research: existing tools](PLAN.md#competitive-landscape)
+- [MCP ecosystem analysis](https://github.com/punkpeye/awesome-mcp-servers) — 83K stars, 600+ servers
+- [Claude Code GitHub issues](https://github.com/anthropics/claude-code) — 280+ issues about config/memory management
+- [Official MCP Registry](https://registry.modelcontextprotocol.io/) — distribution channel

package/README.md

@@ -0,0 +1,123 @@
+# Claude Code Organizer
+
+**Organize all your Claude Code memories, skills, MCP servers, and hooks — view by scope hierarchy, move between scopes via drag-and-drop.**
+
+Claude Code saves your customizations across scattered directories with encoded paths. This tool gives you a visual dashboard to see everything, understand which scope each item applies to, and move items between scopes with one click.
+
+---
+
+## Features
+
+- **Scope-aware hierarchy** — See all items organized as Global > Workspace > Project, with inheritance indicators
+- **Drag-and-drop** — Move memories between scopes, skills between global and per-repo, MCP servers between configs
+- **Move confirmation** — Every move shows a confirmation modal before touching any files
+- **Same-type safety** — Memories can only move to memory folders, skills to skill folders, MCP to MCP configs
+- **Search & filter** — Instantly search across all items, filter by category (Memory, Skills, MCP, Config, Hooks, Plugins, Plans)
+- **Detail panel** — Click any item to see full metadata, description, file path, and open in VS Code
+- **Zero dependencies** — Pure Node.js built-in modules, SortableJS via CDN
+- **Real file moves** — Actually moves files in `~/.claude/`, not just a viewer
+
+## Quick Start
+
+```bash
+# Run directly (no install needed)
+npx @mcpware/claude-code-organizer
+
+# Or install globally
+npm install -g @mcpware/claude-code-organizer
+claude-code-organizer
+```
+
+Opens a dashboard at `http://localhost:3847`. Works with your real `~/.claude/` directory.
+
+## What It Manages
+
+| Type | View | Move Between Scopes |
+|------|:----:|:-------------------:|
+| Memories (feedback, user, project, reference) | Yes | Yes |
+| Skills | Yes | Yes |
+| MCP Servers | Yes | Yes |
+| Config (CLAUDE.md, settings.json) | Yes | Locked |
+| Hooks | Yes | Locked |
+| Plugins | Yes | Locked |
+| Plans | Yes | Locked |
+
+## Scope Hierarchy
+
+```
+Global                          <- applies everywhere
+  AlltrueAi (workspace)         <- applies to all sub-projects
+    ai-security-control-plane   <- project-specific
+    rule-processor              <- project-specific
+  MyGithub (project)            <- independent project
+  Documents (project)           <- independent project
+```
+
+Child scopes inherit parent scope's memories, skills, and MCP servers.
+
+## How It Works
+
+1. **Scans** `~/.claude/` — discovers all projects, memories, skills, MCP servers, hooks, plugins, plans
+2. **Resolves scope hierarchy** — determines parent-child relationships from filesystem paths
+3. **Renders dashboard** — scope headers > category bars > item rows, with proper indentation
+4. **Handles moves** — when you drag or click "Move to...", actually moves files on disk with safety checks
+
+## Comparison
+
+| Feature | Claude Code Organizer | [claude-control](https://github.com/code-by-gunnar/claude-control) | [claude-admin](https://github.com/conradBruchmann/claude-admin) | [Claude Deck](https://claudedeck.org/) |
+|---------|:--------------------:|:--------------:|:------------:|:----------:|
+| View by scope hierarchy | Yes | Yes | Partial | No |
+| Move between scopes | **Yes** | No (read-only) | No | No |
+| Drag-and-drop | **Yes** | No | No | No |
+| Memories management | **Yes** | No | Yes | No |
+| Skills management | **Yes** | Yes | Yes | No |
+| MCP management | **Yes** | Yes | Yes | Yes |
+| Zero dependencies | **Yes** | No | No | No (React+FastAPI+SQLite) |
+| Standalone (no IDE) | **Yes** | Yes | Yes | Yes |
+
+## Platform Support
+
+| Platform | Status |
+|----------|:------:|
+| Ubuntu / Linux | Supported |
+| macOS | Should work (untested) |
+| Windows | Not yet |
+| WSL | Should work (untested) |
+
+## Project Structure
+
+```
+src/
+  scanner.mjs       # Scans ~/.claude/ — pure data, no side effects
+  mover.mjs         # Moves files between scopes — safety checks + rollback
+  server.mjs        # HTTP server — routes only, no logic
+  ui/
+    index.html       # HTML structure
+    style.css        # All styling (edit freely, won't break logic)
+    app.js           # Frontend rendering + SortableJS + interactions
+bin/
+  cli.mjs            # Entry point
+```
+
+Frontend and backend are fully separated. Edit `src/ui/` files to change the look without touching any logic.
+
+## API
+
+The dashboard is backed by a REST API:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/scan` | GET | Scan all customizations, returns scopes + items + counts |
+| `/api/move` | POST | Move an item to a different scope |
+| `/api/destinations` | GET | Get valid move destinations for an item |
+| `/api/file-content` | GET | Read file content for detail panel |
+
+## License
+
+MIT
+
+## Author
+
+[mcpware](https://github.com/mcpware) — Building tools for the Claude Code ecosystem.
+
+See also: [@mcpware/instagram-mcp](https://github.com/mcpware/instagram-mcp)

package/SHIP.md

@@ -0,0 +1,96 @@
+# Ship Plan — claude-code-organizer
+
+> Follow side-hustle/3-ship/ship-workflow.md template
+> Created: 2026-03-18
+
+---
+
+## Phase 0: Launch Checklist (TODAY)
+
+### README
+- [ ] One-line description (3 seconds)
+- [ ] Screenshot / demo GIF at the top
+- [ ] Features bullet list
+- [ ] Quick Start (`npx @mcpware/claude-code-organizer`)
+- [ ] Comparison table (vs claude-control, claude-admin, claude-deck)
+- [ ] Usage examples
+
+### GitHub Repo Setup
+- [ ] Description ✅ (already set)
+- [ ] Topics / Tags (use all 20)
+- [ ] Social Preview Image (1280×640) — use Canva MCP
+- [ ] LICENSE file (MIT)
+- [ ] .gitignore
+- [ ] Release tag (v0.1.0)
+- [ ] Badges (version, license, npm downloads)
+
+### Package Registry
+- [ ] `npm publish --access public` as `@mcpware/claude-code-organizer`
+- [ ] Also publish as `claude-code-organizer` (unscoped, for discoverability)
+
+### Plugin Marketplace
+- [ ] Create `.claude-plugin/plugin.json` manifest
+- [ ] Create marketplace repo `mcpware/marketplace`
+- [ ] Submit to Anthropic official marketplace (claude.ai/settings/plugins/submit)
+
+---
+
+## Phase 1: Registry Registration (Day 1-2)
+
+| Platform | URL | Status | Notes |
+|----------|-----|:------:|-------|
+| **npm** | npmjs.com | [ ] | `@mcpware/claude-code-organizer` + `claude-code-organizer` |
+| **Anthropic Plugin Marketplace** | claude.ai/settings/plugins/submit | [ ] | Official, needs review |
+| **Official MCP Registry** | registry.modelcontextprotocol.io | [ ] | Submit via `mcp-publisher` CLI |
+| **awesome-mcp-servers** | github.com/punkpeye/awesome-mcp-servers | [ ] | PR (need Glama listing first) |
+| **awesome-claude-code** | github.com/hesreallyhim/awesome-claude-code | [ ] | PR |
+| **awesome-claude-plugins** | github.com/ComposioHQ/awesome-claude-plugins | [ ] | PR |
+| **Glama.ai** | glama.ai/mcp/servers | [ ] | Need Dockerfile + glama.json + release tag |
+| **MCP.so** | mcp.so | [ ] | Submit form |
+| **Smithery.ai** | smithery.ai | [ ] | Submit MCP server |
+| **MCPServers.org** | mcpservers.org | [ ] | Submit to directory |
+| **PulseMCP** | pulsemcp.com | [ ] | Submit |
+| **mcpmarket.com** | mcpmarket.com | [ ] | Submit |
+
+### Glama Requirements (blocks awesome-mcp-servers PR)
+- [ ] Add `Dockerfile`
+- [ ] Add `glama.json`
+- [ ] Create GitHub Release v0.1.0
+- [ ] Submit to Glama → Claim → Wait for indexing
+
+---
+
+## Phase 2: Social Media Launch (Day 2-5)
+
+| Day | Platform | Content | Status |
+|-----|----------|---------|:------:|
+| Day 2 | Reddit r/ClaudeAI | "I built a visual organizer for Claude Code memories, skills, and MCP servers" | [ ] |
+| Day 2 | Reddit r/MCP | Technical angle — scope hierarchy + drag-and-drop | [ ] |
+| Day 3 | Twitter/X | Thread: problem → solution → demo GIF → link | [ ] |
+| Day 4 | Dev.to | Blog post: "I was drowning in 84 Claude Code config files" | [ ] |
+| Day 5 | LinkedIn | Professional: "Built an open-source tool used by X developers" | [ ] |
+
+---
+
+## Phase 3: Content Angles
+
+### Problem-first (Dev.to, HN)
+> "Claude Code saves memories, skills, MCP servers, and hooks across 5+ scattered directories with ugly encoded paths. I had 84 config files and couldn't tell which scope each one applied to. So I built Claude Code Organizer — a visual dashboard that shows everything organized by scope hierarchy with drag-and-drop to move items between scopes."
+
+### Comparison (Reddit, Twitter)
+> "There are 10+ Claude Code config tools, but none let you actually MOVE items between scopes. claude-control is read-only. Claude Deck needs React+FastAPI+SQLite. I built a zero-dependency organizer with real drag-and-drop. Here's how they compare: [table]"
+
+### Build-in-public (Twitter)
+> "Day 1: Built a scope-aware inventory manager for Claude Code in one session. Zero npm dependencies, SortableJS for drag-and-drop. Here's what I learned about Claude's config system..."
+
+---
+
+## Execution Order (Today)
+
+1. ~~Rename repo~~ ✅
+2. Write README
+3. Add LICENSE, .gitignore, topics
+4. npm publish
+5. Create plugin structure
+6. Create GitHub Release v0.1.0
+7. Submit to registries

package/bin/cli.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * cli.mjs — Entry point for Claude Inventory Manager.
+ * Usage: node bin/cli.mjs [--port 3847]
+ */
+
+import { startServer } from "../src/server.mjs";
+import { execSync } from "node:child_process";
+
+const args = process.argv.slice(2);
+const portIdx = args.indexOf("--port");
+const port = portIdx !== -1 ? parseInt(args[portIdx + 1], 10) : 3847;
+
+const server = startServer(port);
+
+// Try to open browser
+try {
+  const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
+  execSync(`${openCmd} http://localhost:${port}`, { stdio: "ignore" });
+} catch {
+  // Browser didn't open, user can navigate manually
+}