Skip to content

Commit 084a5fa

Browse files
workromancerworkromancer
committed
feat: document new link and scan commands, and expanded MCP integration tools
1 parent d3d661f commit 084a5fa

2 files changed

Lines changed: 215 additions & 17 deletions

File tree

‎README.ko.md‎

Lines changed: 112 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -44,14 +44,16 @@
4444

4545
### 핵심 기능
4646

47-
| 기능 | 설명 |
48-
| ----------------------- | -------------------------------------------------------- |
49-
| 🔄 **GitHub 동기화** | GitHub 리포지토리를 통해 Claude Code 설정 공유 및 동기화 |
50-
| 📦 **멀티 리포 지원** | 여러 리포지토리에서 독립적으로 풀 및 관리 |
51-
| 📤 **Stage & Apply** | 로컬에서 스테이지, 어디서나 적용 |
52-
| 🎯 **전체 확장 지원** | Skills, Agents, Output Styles 모두 관리 |
53-
| 🔀 **Promote / Demote** | 프로젝트와 사용자 스코프 간 설정 이동 |
54-
| 🔌 **MCP 통합** | MCP 서버를 통한 Claude Code 네이티브 통합 |
47+
| 기능 | 설명 |
48+
| ---------------------------- | -------------------------------------------------------- |
49+
| 🔄 **GitHub 동기화** | GitHub 리포지토리를 통해 Claude Code 설정 공유 및 동기화 |
50+
| 📦 **멀티 리포 지원** | 여러 리포지토리에서 독립적으로 풀 및 관리 |
51+
| 📤 **Stage & Apply** | 로컬에서 스테이지, 어디서나 적용 |
52+
| 🎯 **전체 확장 지원** | Skills, Agents, Output Styles 모두 관리 |
53+
| 🔀 **Promote / Demote** | 프로젝트와 사용자 스코프 간 설정 이동 |
54+
| 🔗 **슬래시 명령어로 연결** | Skills/Agents를 명시적 슬래시 명령어로 변환 |
55+
| 🔍 **로컬 프로젝트 스캔** | 컴퓨터의 모든 .claude 디렉토리 찾기 및 관리 |
56+
| 🔌 **MCP 통합** | MCP 서버를 통한 Claude Code 네이티브 통합 (37개 도구) |
5557

5658
### CLI 기능
5759

@@ -171,6 +173,27 @@ cd my-settings && git init && git add . && git push
171173
| `clsync promote <name> -r <new>` | 충돌 방지를 위해 이름 변경 |
172174
| `clsync demote <name>` | 이동: `~/.claude` → `.claude` |
173175

176+
### 연결 명령어
177+
178+
| 명령어 | 설명 |
179+
| ------------------------------------------ | -------------------------- |
180+
| `clsync link skill <name>` | Skill을 슬래시 명령어로 |
181+
| `clsync link agent <name>` | Subagent를 슬래시 명령어로 |
182+
| `clsync link --all` | 모든 skills/agents 연결 |
183+
| `clsync link --all --skills-only` | Skills만 연결 |
184+
| `clsync link --all --agents-only` | Agents만 연결 |
185+
| `clsync link skill <name> -p` | 프로젝트 스코프에서 연결 |
186+
| `clsync link skill <name> -n <custom>` | 커스텀 명령어 이름으로 |
187+
188+
### 스캔 명령어
189+
190+
| 명령어 | 설명 |
191+
| ---------------------- | ------------------------ |
192+
| `clsync scan` | 로컬 .claude 디렉토리 찾기 |
193+
| `clsync scan -p <dir>` | 특정 디렉토리 스캔 |
194+
| `clsync scan -c` | 스캔 캐시 삭제 |
195+
| `clsync scan -i` | 캐시 정보 표시 |
196+
174197
### 내보내기 명령어
175198

176199
| 명령어 | 설명 |
@@ -227,7 +250,14 @@ cd my-settings && git init && git add . && git push
227250
claude mcp add clsync --transport stdio -- npx -y clsync-mcp
228251
```
229252

230-
### 사용 가능한 도구
253+
### 사용 가능한 도구 (총 37개)
254+
255+
#### 초기화 및 상태 도구
256+
257+
| 도구 | 설명 |
258+
| -------------- | ------------------------- |
259+
| `init_clsync` | ~/.clsync 디렉터리 초기화 |
260+
| `get_status` | 현재 clsync 상태 확인 |
231261

232262
#### 문서 도구
233263

@@ -255,15 +285,29 @@ claude mcp add clsync --transport stdio -- npx -y clsync-mcp
255285
| `read_subagent` | 서브에이전트 내용 읽기 |
256286
| `list_output_styles` | 출력 스타일 목록 |
257287

288+
#### 스테이징 도구
289+
290+
| 도구 | 설명 |
291+
| -------------- | ----------------------------- |
292+
| `stage_item` | ~/.claude 또는 .claude에서 스테이지 |
293+
| `stage_all` | 모든 항목 스테이지 |
294+
| `unstage_item` | 스테이징에서 제거 |
295+
| `list_staged` | 스테이지된 항목 목록 |
296+
258297
#### 리포지토리 도구
259298

299+
| 도구 | 설명 |
300+
| --------------- | -------------------- |
301+
| `pull_settings` | GitHub 리포에서 풀 |
302+
| `push_settings` | GitHub 리포로 푸시 |
303+
| `browse_repo` | 리포 내용 탐색 |
304+
| `list_repos` | 풀한 리포지토리 목록 |
305+
306+
#### 적용 도구
307+
260308
| 도구 | 설명 |
261309
| --------------- | ---------------------- |
262-
| `pull_settings` | GitHub 리포에서 풀 |
263-
| `browse_repo` | 리포 내용 탐색 |
264310
| `apply_setting` | 스테이징에서 설정 적용 |
265-
| `list_staged` | 스테이지된 항목 목록 |
266-
| `list_repos` | 풀한 리포지토리 목록 |
267311

268312
#### 스코프 도구
269313

@@ -273,6 +317,38 @@ claude mcp add clsync --transport stdio -- npx -y clsync-mcp
273317
| `demote_setting` | 사용자 → 프로젝트 이동 |
274318
| `compare_scopes` | 사용자/프로젝트 설정 비교 |
275319

320+
#### 연결 도구
321+
322+
| 도구 | 설명 |
323+
| -------------------------- | --------------------------- |
324+
| `link_skill_to_command` | Skill을 슬래시 명령어로 |
325+
| `link_subagent_to_command` | Subagent를 슬래시 명령어로 |
326+
| `link_all_to_commands` | 모든 skills/agents 연결 |
327+
328+
#### 내보내기 및 로컬 도구
329+
330+
| 도구 | 설명 |
331+
| ------------------- | -------------------------- |
332+
| `export_for_push` | git push를 위한 내보내기 |
333+
| `link_local_repo` | GitHub 리포를 로컬에 연결 |
334+
| `unlink_local_repo` | GitHub 리포 연결 해제 |
335+
| `get_local_info` | 로컬 스테이징 정보 확인 |
336+
337+
#### 온라인 레지스트리 도구
338+
339+
| 도구 | 설명 |
340+
| ------------------- | ------------------------- |
341+
| `list_online_repos` | 온라인 레지스트리 리포 목록 |
342+
| `pull_online_repo` | 온라인 레지스트리에서 풀 |
343+
344+
#### 스캔 도구
345+
346+
| 도구 | 설명 |
347+
| --------------------- | ---------------------- |
348+
| `scan_claude_dirs` | .claude 디렉토리 스캔 |
349+
| `get_scan_cache_info` | 스캔 캐시 정보 확인 |
350+
| `clear_scan_cache` | 스캔 캐시 삭제 |
351+
276352
---
277353

278354
## 📐 아키텍처
@@ -383,6 +459,29 @@ clsync promote my-skill
383459
clsync demote my-agent
384460
```
385461

462+
### 연결: 슬래시 명령어 생성
463+
464+
```bash
465+
# 단일 skill을 슬래시 명령어로 연결
466+
clsync link skill alarm
467+
# 이제 Claude Code에서 /alarm 사용 가능
468+
469+
# Subagent를 슬래시 명령어로 연결
470+
clsync link agent code-reviewer
471+
# 이제 Claude Code에서 /code-reviewer 사용 가능
472+
473+
# 모든 skills와 agents를 한번에 연결
474+
clsync link --all
475+
476+
# Skills만 연결
477+
clsync link --all --skills-only
478+
479+
# 프로젝트 스코프에서 연결
480+
clsync link skill my-skill --project
481+
```
482+
483+
**사용 사례:** 자동 호출되는 skills를 명시적으로 호출 가능한 슬래시 명령어로 변환하여 더 정확한 제어 가능.
484+
386485
---
387486

388487
## 🤝 기여

‎README.md‎

Lines changed: 103 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,9 @@
5151
| 📤 **Stage & Apply** | Stage settings locally, apply them anywhere |
5252
| 🎯 **Full Extension Support** | Manage Skills, Agents, and Output Styles |
5353
| 🔀 **Promote / Demote** | Move settings between project and user scope |
54-
| 🔌 **MCP Integration** | Native Claude Code integration via MCP Server |
54+
| 🔗 **Link to Slash Commands** | Convert skills/agents into explicit slash commands |
55+
| 🔍 **Local Project Scan** | Find and manage all .claude directories on your machine |
56+
| 🔌 **MCP Integration** | Native Claude Code integration via MCP Server (37 tools) |
5557

5658
### CLI Features
5759

@@ -171,6 +173,27 @@ cd my-settings && git init && git add . && git push
171173
| `clsync promote <name> -r <new>` | Rename to avoid conflict |
172174
| `clsync demote <name>` | Move: `~/.claude` → `.claude` |
173175

176+
### Link Commands
177+
178+
| Command | Description |
179+
| ------------------------------------- | -------------------------------------- |
180+
| `clsync link skill <name>` | Link skill to slash command |
181+
| `clsync link agent <name>` | Link subagent to slash command |
182+
| `clsync link --all` | Link all skills and agents |
183+
| `clsync link --all --skills-only` | Link only skills |
184+
| `clsync link --all --agents-only` | Link only agents |
185+
| `clsync link skill <name> -p` | Link in project scope |
186+
| `clsync link skill <name> -n <custom>` | Link with custom command name |
187+
188+
### Scan Commands
189+
190+
| Command | Description |
191+
| ---------------------- | ----------------------------------- |
192+
| `clsync scan` | Find all local .claude directories |
193+
| `clsync scan -p <dir>` | Scan specific directory |
194+
| `clsync scan -c` | Clear scan cache |
195+
| `clsync scan -i` | Show cache info |
196+
174197
### Export Commands
175198

176199
| Command | Description |
@@ -227,7 +250,14 @@ Run `clsync` without arguments to enter interactive mode:
227250
claude mcp add clsync --transport stdio -- npx -y clsync-mcp
228251
```
229252

230-
### Available Tools
253+
### Available Tools (37 total)
254+
255+
#### Init & Status Tools
256+
257+
| Tool | Description |
258+
| -------------- | ----------------------------------- |
259+
| `init_clsync` | Initialize ~/.clsync directory |
260+
| `get_status` | Get current clsync status |
231261

232262
#### Documentation Tools
233263

@@ -255,16 +285,30 @@ claude mcp add clsync --transport stdio -- npx -y clsync-mcp
255285
| `read_subagent` | Read subagent content |
256286
| `list_output_styles` | List output styles |
257287

288+
#### Stage & Unstage Tools
289+
290+
| Tool | Description |
291+
| -------------- | ------------------------------------- |
292+
| `stage_item` | Stage item from ~/.claude or .claude |
293+
| `stage_all` | Stage all items |
294+
| `unstage_item` | Remove item from staging |
295+
| `list_staged` | List staged items |
296+
258297
#### Repository Tools
259298

260299
| Tool | Description |
261300
| --------------- | --------------------------- |
262301
| `pull_settings` | Pull from GitHub repository |
302+
| `push_settings` | Push to GitHub repository |
263303
| `browse_repo` | Browse repository contents |
264-
| `apply_setting` | Apply setting from staging |
265-
| `list_staged` | List staged items |
266304
| `list_repos` | List pulled repositories |
267305

306+
#### Apply Tools
307+
308+
| Tool | Description |
309+
| --------------- | -------------------------- |
310+
| `apply_setting` | Apply setting from staging |
311+
268312
#### Scope Tools
269313

270314
| Tool | Description |
@@ -273,6 +317,38 @@ claude mcp add clsync --transport stdio -- npx -y clsync-mcp
273317
| `demote_setting` | Move user → project |
274318
| `compare_scopes` | Compare user and project settings |
275319

320+
#### Link Tools
321+
322+
| Tool | Description |
323+
| ------------------------ | ----------------------------------- |
324+
| `link_skill_to_command` | Link skill to slash command |
325+
| `link_subagent_to_command` | Link subagent to slash command |
326+
| `link_all_to_commands` | Link all skills and agents |
327+
328+
#### Export & Local Tools
329+
330+
| Tool | Description |
331+
| ------------------- | -------------------------------- |
332+
| `export_for_push` | Export staged items for git push |
333+
| `link_local_repo` | Link GitHub repo to local |
334+
| `unlink_local_repo` | Unlink GitHub repo |
335+
| `get_local_info` | Get local staging info |
336+
337+
#### Online Registry Tools
338+
339+
| Tool | Description |
340+
| ------------------- | ----------------------------------- |
341+
| `list_online_repos` | List online registry repositories |
342+
| `pull_online_repo` | Pull from online registry |
343+
344+
#### Scan Tools
345+
346+
| Tool | Description |
347+
| --------------------- | ---------------------------- |
348+
| `scan_claude_dirs` | Scan for .claude directories |
349+
| `get_scan_cache_info` | Get scan cache information |
350+
| `clear_scan_cache` | Clear scan cache |
351+
276352
---
277353

278354
## 📐 Architecture
@@ -383,6 +459,29 @@ clsync promote my-skill
383459
clsync demote my-agent
384460
```
385461

462+
### Link: Create Slash Commands
463+
464+
```bash
465+
# Link a single skill to slash command
466+
clsync link skill alarm
467+
# Now use /alarm in Claude Code
468+
469+
# Link a subagent to slash command
470+
clsync link agent code-reviewer
471+
# Now use /code-reviewer in Claude Code
472+
473+
# Link all skills and agents at once
474+
clsync link --all
475+
476+
# Link only skills
477+
clsync link --all --skills-only
478+
479+
# Link in project scope
480+
clsync link skill my-skill --project
481+
```
482+
483+
**Use Case:** Convert auto-invoked skills into explicitly callable slash commands for more control.
484+
386485
---
387486

388487
## 🤝 Contributing

0 commit comments

Comments
 (0)