@mcpware/claude-code-organizer 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +110 -0
- package/README.ko.md +110 -0
- package/README.md +7 -1
- package/README.zh-CN.md +110 -0
- package/README.zh-TW.md +110 -0
- package/package.json +1 -1
- package/server.json +2 -2
package/README.ja.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Claude Code Organizer
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@mcpware/claude-code-organizer)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
|
|
7
|
+
[English](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | 日本語 | [한국어](README.ko.md)
|
|
8
|
+
|
|
9
|
+
**Claude Code のメモリ・スキル・MCPサーバー・フックをまとめて管理できるダッシュボード。スコープ階層で一覧表示、ドラッグ＆ドロップでスコープ間を移動。**
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## こんな経験ない？
|
|
14
|
+
|
|
15
|
+
Claude Code に「これ覚えて」って言ったのに、**違うスコープに保存されてた**こと、ありませんか？
|
|
16
|
+
|
|
17
|
+
あるあるなのが：プロジェクトフォルダの中で Claude に設定を覚えさせたら、そのプロジェクト専用のスコープに保存される。別のプロジェクトに切り替えると、Claude はその設定を知らない。メモリが元のプロジェクトに閉じ込められてしまう。
|
|
18
|
+
|
|
19
|
+
逆パターンもある — グローバルスコープに入ってるスキルやメモリが、実は特定のリポジトリでしか使わないのに、全プロジェクトに漏れてしまう。
|
|
20
|
+
|
|
21
|
+
手動で直す？ `~/.claude/` の中を掘って、`-home-user-projects-my-app/` みたいなエンコードされたパスのフォルダを探して、該当ファイルを見つけて自分で移動する……正直、かなり面倒。
|
|
22
|
+
|
|
23
|
+
**Claude Code Organizer はこの問題を解決します。**
|
|
24
|
+
|
|
25
|
+
### 例：プロジェクト → グローバル
|
|
26
|
+
|
|
27
|
+
プロジェクト内で Claude に「TypeScript + ESM がいい」と覚えさせた。でもこの設定、全プロジェクトで使いたい。ダッシュボードを開いて、そのメモリをプロジェクトからグローバルにドラッグ。以上。
|
|
28
|
+
|
|
29
|
+
### 例：グローバル → プロジェクト
|
|
30
|
+
|
|
31
|
+
グローバルにデプロイ用スキルがあるけど、実際に使うのは1つのリポジトリだけ。そのプロジェクトにドラッグすれば、他のプロジェクトからは見えなくなる。スッキリ。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 機能
|
|
36
|
+
|
|
37
|
+
- **スコープ階層ビュー** — Global > Workspace > Project で整理、継承関係もひと目でわかる
|
|
38
|
+
- **ドラッグ＆ドロップ** — メモリ・スキル・MCPサーバーをスコープ間で移動
|
|
39
|
+
- **移動前に確認** — ファイルを触る前に必ず確認ダイアログが出る
|
|
40
|
+
- **型の安全性** — メモリはメモリフォルダにだけ、スキルはスキルフォルダにだけ移動可能
|
|
41
|
+
- **検索＆フィルター** — 全アイテムをリアルタイム検索、カテゴリ別フィルター（メモリ、スキル、MCP、設定、フック、プラグイン、プラン）
|
|
42
|
+
- **詳細パネル** — アイテムをクリックするとメタデータ・説明・ファイルパスを表示、VS Code で直接開ける
|
|
43
|
+
- **依存ゼロ** — 純粋な Node.js ビルトインモジュールのみ、SortableJS は CDN 経由
|
|
44
|
+
- **ガチのファイル移動** — `~/.claude/` 内のファイルを実際に移動する。閲覧専用ツールじゃない
|
|
45
|
+
|
|
46
|
+
## クイックスタート
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# そのまま実行（インストール不要）
|
|
50
|
+
npx @mcpware/claude-code-organizer
|
|
51
|
+
|
|
52
|
+
# グローバルインストールしてもOK
|
|
53
|
+
npm install -g @mcpware/claude-code-organizer
|
|
54
|
+
claude-code-organizer
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
もしくは、Claude Code にこう伝えるだけ：
|
|
58
|
+
|
|
59
|
+
> `npx @mcpware/claude-code-organizer` を実行して。Claude Code の設定を管理するダッシュボードだよ。URLを教えて。
|
|
60
|
+
|
|
61
|
+
`http://localhost:3847` でダッシュボードが開きます。実際の `~/.claude/` ディレクトリを操作します。
|
|
62
|
+
|
|
63
|
+
## 管理できるもの
|
|
64
|
+
|
|
65
|
+
| タイプ | 閲覧 | スコープ間移動 |
|
|
66
|
+
|--------|:----:|:------------:|
|
|
67
|
+
| メモリ（feedback、user、project、reference） | ✅ | ✅ |
|
|
68
|
+
| スキル | ✅ | ✅ |
|
|
69
|
+
| MCPサーバー | ✅ | ✅ |
|
|
70
|
+
| 設定（CLAUDE.md、settings.json） | ✅ | 🔒 |
|
|
71
|
+
| フック | ✅ | 🔒 |
|
|
72
|
+
| プラグイン | ✅ | 🔒 |
|
|
73
|
+
| プラン | ✅ | 🔒 |
|
|
74
|
+
|
|
75
|
+
## スコープ階層
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
Global <- 全プロジェクトに適用
|
|
79
|
+
会社 (Workspace) <- 配下の全サブプロジェクトに適用
|
|
80
|
+
会社リポ1 <- このプロジェクト専用
|
|
81
|
+
会社リポ2 <- このプロジェクト専用
|
|
82
|
+
個人開発 (Project) <- 独立したプロジェクト
|
|
83
|
+
ドキュメント (Project) <- 独立したプロジェクト
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
子スコープは親スコープのメモリ・スキル・MCPサーバーを自動的に継承します。
|
|
87
|
+
|
|
88
|
+
## 仕組み
|
|
89
|
+
|
|
90
|
+
1. **スキャン** `~/.claude/` — プロジェクト・メモリ・スキル・MCPサーバー・フック・プラグイン・プランを検出
|
|
91
|
+
2. **階層を解決** — ファイルシステムのパスから親子関係を特定
|
|
92
|
+
3. **ダッシュボード描画** — スコープヘッダー > カテゴリバー > アイテム行、適切にインデント
|
|
93
|
+
4. **移動処理** — ドラッグまたは「移動先…」クリックで、安全チェック付きでファイルを実際に移動
|
|
94
|
+
|
|
95
|
+
## プラットフォーム
|
|
96
|
+
|
|
97
|
+
| プラットフォーム | 状態 |
|
|
98
|
+
|----------------|:----:|
|
|
99
|
+
| Ubuntu / Linux | ✅ サポート済み |
|
|
100
|
+
| macOS | たぶん動く（未テスト） |
|
|
101
|
+
| Windows | 未対応 |
|
|
102
|
+
| WSL | たぶん動く（未テスト） |
|
|
103
|
+
|
|
104
|
+
## ライセンス
|
|
105
|
+
|
|
106
|
+
MIT
|
|
107
|
+
|
|
108
|
+
## 作者
|
|
109
|
+
|
|
110
|
+
[ithiria894](https://github.com/ithiria894) — Claude Code エコシステム向けのツールを開発中。
|
package/README.ko.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Claude Code Organizer
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@mcpware/claude-code-organizer)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
|
|
7
|
+
[English](README.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | 한국어
|
|
8
|
+
|
|
9
|
+
**Claude Code의 메모리, 스킬, MCP 서버, 훅을 한눈에 관리하는 대시보드. 스코프 계층으로 정리하고, 드래그 앤 드롭으로 스코프 간 이동.**
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## 이런 적 있지 않나요?
|
|
14
|
+
|
|
15
|
+
Claude Code한테 "이거 기억해"라고 했는데, **엉뚱한 스코프에 저장된 적** 없나요?
|
|
16
|
+
|
|
17
|
+
흔한 시나리오: 프로젝트 폴더 안에서 Claude한테 설정을 기억시키면, 그 프로젝트 스코프에 저장됩니다. 다른 프로젝트로 넘어가면? Claude는 모릅니다. 그 메모리는 원래 프로젝트에 갇혀버립니다.
|
|
18
|
+
|
|
19
|
+
반대도 마찬가지 — 글로벌 스코프에 있는 스킬이나 메모리가 실제로는 하나의 레포에서만 쓰는 건데, 모든 프로젝트에 새어 나갑니다.
|
|
20
|
+
|
|
21
|
+
직접 고치려면? `~/.claude/` 안에서 `-home-user-projects-my-app/` 같은 인코딩된 경로 폴더를 뒤져서 해당 파일을 찾아 수동으로 옮겨야 합니다. 솔직히 꽤 번거롭죠.
|
|
22
|
+
|
|
23
|
+
**Claude Code Organizer가 이 문제를 해결합니다.**
|
|
24
|
+
|
|
25
|
+
### 예시: 프로젝트 → 글로벌
|
|
26
|
+
|
|
27
|
+
프로젝트 안에서 "TypeScript + ESM 선호"를 기억시켰는데, 이 설정은 모든 곳에서 적용돼야 합니다. 대시보드 열고, 그 메모리를 프로젝트에서 글로벌로 드래그. 끝.
|
|
28
|
+
|
|
29
|
+
### 예시: 글로벌 → 프로젝트
|
|
30
|
+
|
|
31
|
+
글로벌에 배포 스킬이 있는데, 실제로는 하나의 레포에서만 씁니다. 해당 프로젝트로 드래그하면 다른 프로젝트에서는 안 보입니다. 깔끔.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 기능
|
|
36
|
+
|
|
37
|
+
- **스코프 계층 뷰** — Global > Workspace > Project로 정리, 상속 관계도 한눈에
|
|
38
|
+
- **드래그 앤 드롭** — 메모리, 스킬, MCP 서버를 스코프 간에 바로 이동
|
|
39
|
+
- **이동 전 확인** — 파일 건드리기 전에 반드시 확인 모달 표시
|
|
40
|
+
- **타입 안전성** — 메모리는 메모리 폴더로만, 스킬은 스킬 폴더로만 이동 가능
|
|
41
|
+
- **검색 & 필터** — 모든 항목 실시간 검색, 카테고리별 필터 (메모리, 스킬, MCP, 설정, 훅, 플러그인, 플랜)
|
|
42
|
+
- **상세 패널** — 항목 클릭하면 메타데이터, 설명, 파일 경로 확인 + VS Code에서 바로 열기
|
|
43
|
+
- **의존성 제로** — 순수 Node.js 내장 모듈, SortableJS는 CDN으로
|
|
44
|
+
- **진짜 파일 이동** — `~/.claude/` 안의 파일을 실제로 옮깁니다. 보기만 하는 뷰어가 아닙니다
|
|
45
|
+
|
|
46
|
+
## 빠른 시작
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# 바로 실행 (설치 필요 없음)
|
|
50
|
+
npx @mcpware/claude-code-organizer
|
|
51
|
+
|
|
52
|
+
# 글로벌 설치도 가능
|
|
53
|
+
npm install -g @mcpware/claude-code-organizer
|
|
54
|
+
claude-code-organizer
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
아니면 Claude Code한테 이렇게 말하세요:
|
|
58
|
+
|
|
59
|
+
> `npx @mcpware/claude-code-organizer` 실행해줘. Claude Code 설정 관리하는 대시보드야. 준비되면 URL 알려줘.
|
|
60
|
+
|
|
61
|
+
`http://localhost:3847`에서 대시보드가 열립니다. 실제 `~/.claude/` 디렉토리를 직접 조작합니다.
|
|
62
|
+
|
|
63
|
+
## 관리 대상
|
|
64
|
+
|
|
65
|
+
| 타입 | 보기 | 스코프 간 이동 |
|
|
66
|
+
|------|:----:|:------------:|
|
|
67
|
+
| 메모리 (feedback, user, project, reference) | ✅ | ✅ |
|
|
68
|
+
| 스킬 | ✅ | ✅ |
|
|
69
|
+
| MCP 서버 | ✅ | ✅ |
|
|
70
|
+
| 설정 (CLAUDE.md, settings.json) | ✅ | 🔒 |
|
|
71
|
+
| 훅 | ✅ | 🔒 |
|
|
72
|
+
| 플러그인 | ✅ | 🔒 |
|
|
73
|
+
| 플랜 | ✅ | 🔒 |
|
|
74
|
+
|
|
75
|
+
## 스코프 계층
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
Global <- 모든 곳에 적용
|
|
79
|
+
회사 (Workspace) <- 하위 모든 프로젝트에 적용
|
|
80
|
+
회사레포1 <- 이 프로젝트 전용
|
|
81
|
+
회사레포2 <- 이 프로젝트 전용
|
|
82
|
+
사이드프로젝트 (Project) <- 독립 프로젝트
|
|
83
|
+
문서 (Project) <- 독립 프로젝트
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
하위 스코프는 상위 스코프의 메모리, 스킬, MCP 서버를 자동으로 상속합니다.
|
|
87
|
+
|
|
88
|
+
## 작동 방식
|
|
89
|
+
|
|
90
|
+
1. **스캔** `~/.claude/` — 모든 프로젝트, 메모리, 스킬, MCP 서버, 훅, 플러그인, 플랜 탐색
|
|
91
|
+
2. **계층 파악** — 파일 시스템 경로에서 부모-자식 관계 추론
|
|
92
|
+
3. **대시보드 렌더링** — 스코프 헤더 > 카테고리 바 > 항목 목록, 자동 들여쓰기
|
|
93
|
+
4. **이동 처리** — 드래그하거나 "이동…" 클릭하면 안전 검사 후 파일을 실제로 이동
|
|
94
|
+
|
|
95
|
+
## 플랫폼
|
|
96
|
+
|
|
97
|
+
| 플랫폼 | 상태 |
|
|
98
|
+
|--------|:----:|
|
|
99
|
+
| Ubuntu / Linux | ✅ 지원 |
|
|
100
|
+
| macOS | 아마 됩니다 (미테스트) |
|
|
101
|
+
| Windows | 미지원 |
|
|
102
|
+
| WSL | 아마 됩니다 (미테스트) |
|
|
103
|
+
|
|
104
|
+
## 라이선스
|
|
105
|
+
|
|
106
|
+
MIT
|
|
107
|
+
|
|
108
|
+
## 만든 사람
|
|
109
|
+
|
|
110
|
+
[ithiria894](https://github.com/ithiria894) — Claude Code 생태계를 위한 도구 제작.
|
package/README.md
CHANGED
|
@@ -1,8 +1,14 @@
|
|
|
1
1
|
# Claude Code Organizer
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@mcpware/claude-code-organizer)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
|
|
7
|
+
English | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
|
|
8
|
+
|
|
3
9
|
**Organize all your Claude Code memories, skills, MCP servers, and hooks — view by scope hierarchy, move between scopes via drag-and-drop.**
|
|
4
10
|
|
|
5
|
-
|
|
11
|
+
|
|
6
12
|
|
|
7
13
|
## The Problem
|
|
8
14
|
|
package/README.zh-CN.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Claude Code Organizer
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@mcpware/claude-code-organizer)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
|
|
7
|
+
[English](README.md) | 简体中文 | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md) | [한국어](README.ko.md)
|
|
8
|
+
|
|
9
|
+
**一个仪表盘，帮你管理 Claude Code 的所有记忆、技能、MCP 服务器和钩子 — 按作用域分层展示，拖拽即可跨作用域移动。**
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## 痛点
|
|
14
|
+
|
|
15
|
+
你有没有跟 Claude Code 说过"记住这个"，结果发现它存错地方了？
|
|
16
|
+
|
|
17
|
+
比如你在某个项目文件夹里，让 Claude 记住一个偏好设置。它就存到了这个项目的作用域下。等你切到另一个项目，Claude 完全不知道有这回事 — 那条记忆被锁死在原来的项目里了。
|
|
18
|
+
|
|
19
|
+
反过来也一样坑：有些技能或记忆放在全局作用域，其实只对某一个仓库有用，结果污染了你所有的项目。
|
|
20
|
+
|
|
21
|
+
想手动修？那你得自己去翻 `~/.claude/` 目录，在一堆 `-home-user-projects-my-app/` 这种编码路径的文件夹里找到对应的文件，手动剪切粘贴。说实话，挺折腾的。
|
|
22
|
+
|
|
23
|
+
**Claude Code Organizer 就是来解决这个问题的。**
|
|
24
|
+
|
|
25
|
+
### 举个例子：项目 → 全局
|
|
26
|
+
|
|
27
|
+
你在某个项目里让 Claude 记住了"我喜欢用 TypeScript + ESM"。但这个偏好你希望全局生效。打开仪表盘，把那条记忆从项目拖到全局。搞定，一步到位。
|
|
28
|
+
|
|
29
|
+
### 举个例子：全局 → 项目
|
|
30
|
+
|
|
31
|
+
你有一个部署技能放在全局，但其实只有一个仓库用得上。把它拖到那个项目里去 — 其他项目就不会再看到它了。干净利落。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 功能
|
|
36
|
+
|
|
37
|
+
- **作用域分层视图** — 全局 > 工作区 > 项目，清晰的层级关系，还有继承标记
|
|
38
|
+
- **拖拽移动** — 记忆、技能、MCP 服务器，拖一下就能换作用域
|
|
39
|
+
- **移动前确认** — 每次操作前弹确认框，不会误操作
|
|
40
|
+
- **类型隔离** — 记忆只能移到记忆文件夹，技能只能移到技能文件夹，不会搞混
|
|
41
|
+
- **搜索 & 筛选** — 实时搜索所有条目，支持按类别筛选（记忆、技能、MCP、配置、钩子、插件、计划）
|
|
42
|
+
- **详情面板** — 点击任意条目查看元数据、描述、文件路径，还能直接用 VS Code 打开
|
|
43
|
+
- **零依赖** — 纯 Node.js 内置模块，SortableJS 走 CDN
|
|
44
|
+
- **真·文件移动** — 直接操作 `~/.claude/` 目录里的文件，不是什么只读查看器
|
|
45
|
+
|
|
46
|
+
## 快速上手
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# 直接跑，不用装
|
|
50
|
+
npx @mcpware/claude-code-organizer
|
|
51
|
+
|
|
52
|
+
# 也可以全局安装
|
|
53
|
+
npm install -g @mcpware/claude-code-organizer
|
|
54
|
+
claude-code-organizer
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
或者直接把下面这段话丢给 Claude Code：
|
|
58
|
+
|
|
59
|
+
> 帮我跑 `npx @mcpware/claude-code-organizer`，这是一个管理 Claude Code 设置的仪表盘。跑起来之后告诉我 URL。
|
|
60
|
+
|
|
61
|
+
浏览器打开 `http://localhost:3847`，直接操作你本地的 `~/.claude/` 目录。
|
|
62
|
+
|
|
63
|
+
## 管理范围
|
|
64
|
+
|
|
65
|
+
| 类型 | 查看 | 跨作用域移动 |
|
|
66
|
+
|------|:----:|:----------:|
|
|
67
|
+
| 记忆（反馈、用户、项目、引用） | ✅ | ✅ |
|
|
68
|
+
| 技能 | ✅ | ✅ |
|
|
69
|
+
| MCP 服务器 | ✅ | ✅ |
|
|
70
|
+
| 配置（CLAUDE.md、settings.json） | ✅ | 🔒 |
|
|
71
|
+
| 钩子 | ✅ | 🔒 |
|
|
72
|
+
| 插件 | ✅ | 🔒 |
|
|
73
|
+
| 计划 | ✅ | 🔒 |
|
|
74
|
+
|
|
75
|
+
## 作用域层级
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
全局 <- 到处生效
|
|
79
|
+
公司 (工作区) <- 下面所有子项目都继承
|
|
80
|
+
公司仓库1 <- 仅限这个项目
|
|
81
|
+
公司仓库2 <- 仅限这个项目
|
|
82
|
+
个人项目 (项目) <- 独立项目
|
|
83
|
+
文档 (项目) <- 独立项目
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
子作用域自动继承父作用域的记忆、技能和 MCP 服务器配置。
|
|
87
|
+
|
|
88
|
+
## 原理
|
|
89
|
+
|
|
90
|
+
1. **扫描** `~/.claude/` — 找出所有项目、记忆、技能、MCP 服务器、钩子、插件、计划
|
|
91
|
+
2. **解析层级** — 根据文件系统路径推导出父子关系
|
|
92
|
+
3. **渲染仪表盘** — 作用域标题 > 类别栏 > 条目列表，自动缩进
|
|
93
|
+
4. **处理移动** — 拖拽或点"移动到…"，后台做完安全检查后直接移动文件
|
|
94
|
+
|
|
95
|
+
## 平台
|
|
96
|
+
|
|
97
|
+
| 平台 | 状态 |
|
|
98
|
+
|------|:----:|
|
|
99
|
+
| Ubuntu / Linux | ✅ 已支持 |
|
|
100
|
+
| macOS | 应该没问题（还没测） |
|
|
101
|
+
| Windows | 暂不支持 |
|
|
102
|
+
| WSL | 应该没问题（还没测） |
|
|
103
|
+
|
|
104
|
+
## 许可证
|
|
105
|
+
|
|
106
|
+
MIT
|
|
107
|
+
|
|
108
|
+
## 作者
|
|
109
|
+
|
|
110
|
+
[ithiria894](https://github.com/ithiria894) — 给 Claude Code 生态造轮子。
|
package/README.zh-TW.md
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Claude Code Organizer
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@mcpware/claude-code-organizer)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://nodejs.org)
|
|
6
|
+
|
|
7
|
+
[English](README.md) | [简体中文](README.zh-CN.md) | 繁體中文 | [日本語](README.ja.md) | [한국어](README.ko.md)
|
|
8
|
+
|
|
9
|
+
**一個儀表板，幫你管理 Claude Code 的所有記憶、技能、MCP 伺服器和 Hook — 按 scope 分層顯示，拖拉就能跨 scope 搬移。**
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
## 問題
|
|
14
|
+
|
|
15
|
+
你有沒有跟 Claude Code 說過「記住這個」，結果它存錯 scope？
|
|
16
|
+
|
|
17
|
+
舉個例子：你在某個專案資料夾裡，請 Claude 記住一個偏好設定。它就存到了那個專案的 scope 底下。等你切到另一個專案，Claude 完全不曉得有這件事 — 那條記憶就被關在原來的專案裡了。
|
|
18
|
+
|
|
19
|
+
反過來也很煩：有些技能或記憶放在 global scope，實際上只跟某一個 repo 有關，結果滲透到你所有的專案裡。
|
|
20
|
+
|
|
21
|
+
想手動修？那你得自己去翻 `~/.claude/` 目錄，在一堆 `-home-user-projects-my-app/` 這種編碼路徑資料夾裡找到對的檔案，自己搬。說真的，很麻煩。
|
|
22
|
+
|
|
23
|
+
**Claude Code Organizer 就是來解決這件事的。**
|
|
24
|
+
|
|
25
|
+
### 範例：專案 → 全域
|
|
26
|
+
|
|
27
|
+
你在某個專案裡讓 Claude 記住了「我偏好 TypeScript + ESM」。但這個偏好你希望全域生效。打開儀表板，把那條記憶從專案 scope 拖到 global scope。搞定。
|
|
28
|
+
|
|
29
|
+
### 範例：全域 → 專案
|
|
30
|
+
|
|
31
|
+
你有一個 deploy 技能放在 global，但其實只有一個 repo 用得到。把它拖到那個專案裡 — 其他專案就再也看不到它了。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 功能
|
|
36
|
+
|
|
37
|
+
- **Scope 分層檢視** — Global > Workspace > Project，層級一目瞭然，附繼承標記
|
|
38
|
+
- **拖拉搬移** — 記憶、技能、MCP 伺服器，拖一下就能換 scope
|
|
39
|
+
- **搬移前確認** — 每次操作前跳確認視窗，不怕手滑
|
|
40
|
+
- **同類型隔離** — 記憶只能搬到記憶資料夾，技能只能搬到技能資料夾，不會搞混
|
|
41
|
+
- **搜尋 & 篩選** — 即時搜尋所有項目，可依類別篩選（記憶、技能、MCP、設定、Hook、Plugin、Plan）
|
|
42
|
+
- **詳情面板** — 點任意項目查看 metadata、說明、檔案路徑，還能直接用 VS Code 開啟
|
|
43
|
+
- **零相依** — 純 Node.js 內建模組，SortableJS 走 CDN
|
|
44
|
+
- **真・檔案搬移** — 直接動 `~/.claude/` 裡的檔案，不是只能看的 viewer
|
|
45
|
+
|
|
46
|
+
## 快速開始
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# 直接執行，不用安裝
|
|
50
|
+
npx @mcpware/claude-code-organizer
|
|
51
|
+
|
|
52
|
+
# 或是全域安裝
|
|
53
|
+
npm install -g @mcpware/claude-code-organizer
|
|
54
|
+
claude-code-organizer
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
或是直接把這段話貼給 Claude Code：
|
|
58
|
+
|
|
59
|
+
> 幫我跑 `npx @mcpware/claude-code-organizer`，這是管理 Claude Code 設定的儀表板。跑起來後告訴我 URL。
|
|
60
|
+
|
|
61
|
+
瀏覽器打開 `http://localhost:3847`，直接操作你本機的 `~/.claude/` 目錄。
|
|
62
|
+
|
|
63
|
+
## 管理範圍
|
|
64
|
+
|
|
65
|
+
| 類型 | 檢視 | 跨 Scope 搬移 |
|
|
66
|
+
|------|:----:|:------------:|
|
|
67
|
+
| 記憶（feedback、user、project、reference） | ✅ | ✅ |
|
|
68
|
+
| 技能 | ✅ | ✅ |
|
|
69
|
+
| MCP 伺服器 | ✅ | ✅ |
|
|
70
|
+
| 設定（CLAUDE.md、settings.json） | ✅ | 🔒 |
|
|
71
|
+
| Hook | ✅ | 🔒 |
|
|
72
|
+
| Plugin | ✅ | 🔒 |
|
|
73
|
+
| Plan | ✅ | 🔒 |
|
|
74
|
+
|
|
75
|
+
## Scope 層級
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
Global <- 到處生效
|
|
79
|
+
公司 (Workspace) <- 底下所有子專案繼承
|
|
80
|
+
公司Repo1 <- 僅限這個專案
|
|
81
|
+
公司Repo2 <- 僅限這個專案
|
|
82
|
+
Side Project (Project) <- 獨立專案
|
|
83
|
+
Docs (Project) <- 獨立專案
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
子 scope 會自動繼承父 scope 的記憶、技能和 MCP 伺服器設定。
|
|
87
|
+
|
|
88
|
+
## 原理
|
|
89
|
+
|
|
90
|
+
1. **掃描** `~/.claude/` — 找出所有專案、記憶、技能、MCP 伺服器、Hook、Plugin、Plan
|
|
91
|
+
2. **解析層級** — 從檔案系統路徑推導出父子關係
|
|
92
|
+
3. **繪製儀表板** — Scope 標題 > 類別列 > 項目清單，自動縮排
|
|
93
|
+
4. **處理搬移** — 拖拉或點「移動到…」，後端做完安全檢查後直接搬檔案
|
|
94
|
+
|
|
95
|
+
## 平台支援
|
|
96
|
+
|
|
97
|
+
| 平台 | 狀態 |
|
|
98
|
+
|------|:----:|
|
|
99
|
+
| Ubuntu / Linux | ✅ 已支援 |
|
|
100
|
+
| macOS | 應該沒問題（尚未測試） |
|
|
101
|
+
| Windows | 暫不支援 |
|
|
102
|
+
| WSL | 應該沒問題（尚未測試） |
|
|
103
|
+
|
|
104
|
+
## 授權
|
|
105
|
+
|
|
106
|
+
MIT
|
|
107
|
+
|
|
108
|
+
## 作者
|
|
109
|
+
|
|
110
|
+
[ithiria894](https://github.com/ithiria894) — 替 Claude Code 生態系打造工具。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcpware/claude-code-organizer",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Organize all your Claude Code memories, skills, MCP servers, and hooks — view by scope hierarchy, move between scopes via drag-and-drop",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/server.json
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
"url": "https://github.com/mcpware/claude-code-organizer",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.2.
|
|
9
|
+
"version": "0.2.2",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"identifier": "@mcpware/claude-code-organizer",
|
|
14
|
-
"version": "0.2.
|
|
14
|
+
"version": "0.2.2",
|
|
15
15
|
"transport": {
|
|
16
16
|
"type": "stdio"
|
|
17
17
|
}
|