v0.2.4

CLSYNC v0.2.4 Release Notes

Release Date: January 4, 2026

---

🎉 Highlights

This release introduces powerful local project discovery capabilities and slash command linking, making it easier than ever to manage Claude Code environments across your entire machine.

---

✨ New Features

🔍 Local Claude Project Scanner

Discover and manage all Claude Code projects on your machine with the new scan command suite.

# Scan for all local .claude directories
clsync scan

# Scan a specific directory
clsync scan -p ~/projects

# View cache info
clsync scan -i

# Clear scan cache
clsync scan -c

Key Capabilities:

• Automatic Discovery: Recursively finds all .claude directories
• Smart Caching: Caches scan results for faster subsequent access
• Interactive Browser: Browse discovered projects with pagination support
• Deep Inspection: View project-level skills, subagents, and slash commands for any discovered project
• Direct Actions: Open projects in Finder, copy paths, or launch Claude directly

🔗 Link Skills & Agents to Slash Commands

Convert your skills and subagents into explicitly callable slash commands for greater control.

# Link a skill to slash command
clsync link skill alarm
# Now use /alarm in Claude Code

# Link a subagent to slash command
clsync link agent code-reviewer
# Now use /code-reviewer in Claude Code

# Link all skills and agents at once
clsync link --all

# Link only skills
clsync link --all --skills-only

# Link only agents
clsync link --all --agents-only

# Link in project scope
clsync link skill my-skill --project

# Link with a custom command name
clsync link skill my-skill -n custom-name

Dependencies:

• Added gray-matter for parsing skill/subagent frontmatter

---

🔌 MCP Server Enhancements

Expanded from 28 to 37 tools with comprehensive coverage of new features.

New Init & Status Tools

Tool	Description
init_clsync	Initialize ~/.clsync directory
get_status	Get current clsync status

New Staging & Export Tools

Tool	Description
stage_item	Stage item from ~/.claude or .claude
stage_all	Stage all items
unstage_item	Remove item from staging
list_staged	List staged items
export_for_push	Export staged items for git push

New Local Repo Management Tools

Tool	Description
link_local_repo	Link GitHub repo to local staging
unlink_local_repo	Unlink GitHub repo from local staging
get_local_info	Get local staging area info

New Online Registry Tools

Tool	Description
list_online_repos	List repositories from online registry
pull_online_repo	Pull from online registry

New Scan Tools

Tool	Description
scan_claude_dirs	Scan for .claude directories
get_scan_cache_info	Get scan cache information
clear_scan_cache	Clear scan cache

New Link Tools

Tool	Description
link_skill_to_command	Link skill to slash command
link_subagent_to_command	Link subagent to slash command
link_all_to_commands	Link all skills and agents

---

📚 Documentation Updates

• Added comprehensive documentation for scan command suite
• Added documentation for link command with examples
• Updated MCP Server tool reference (37 tools total)
• Added new workflow examples for scan and link features

---

📦 Installation

npm install -g clsync@0.2.4

🔌 MCP Server Setup

claude mcp add clsync --transport stdio -- npx -y clsync-mcp

---

📝 Changelog

Added

• clsync scan command for discovering local Claude projects
• clsync scan -p <dir> for scanning specific directories
• clsync scan -i for viewing cache information
• clsync scan -c for clearing scan cache
• Interactive scan browser with pagination
• Project settings inspector (view skills, agents, slash commands)
• clsync link skill <name> command
• clsync link agent <name> command
• clsync link --all for batch linking
• --skills-only and --agents-only flags for selective linking
• --project flag for project-scope linking
• -n <name> option for custom slash command names
• 9 new MCP Server tools for scan, link, and status operations
• gray-matter dependency for frontmatter parsing

Changed

• MCP Server now provides 37 tools (up from 28)
• Updated CLI banner to show v0.2.4

---

Full Changelog: 0.2.3...v0.2.4

0.2.3

v0.2.3

✨ New Features

• clsync push command - Push your settings to a GitHub repository

  # Push from local staging (~/.clsync/local)
  clsync push owner/my-claude-settings
  
  # Push from user scope (~/.claude)
  clsync push -s user owner/my-settings
  
  # Push from project scope (.claude)
  clsync push -s project owner/my-settings
  
  # With custom commit message
  clsync push -m "Add new skill" owner/repo
  

Full Changelog: 0.2.2...0.2.3

0.2.2

v0.2.2

🐛 Bug Fixes

• Fixed MCP tool parameter passing issue - Migrated from deprecated server.tool() to server.registerTool() with Zod schemas, resolving the "Error: 'name' parameter is required" error that occurred even when parameters were provided
• MCP SDK 1.25.x compatibility - inputSchema now correctly includes properties and required fields, allowing Claude Code to properly recognize tool parameters

✨ Improvements

• Default scope changed to project - create_skill and create_subagent now default to project scope (.claude/) instead of user scope (~/.claude/). To create globally, explicitly specify scope: "user"

📦 Technical Changes

• Migrated all 19 MCP tools to Zod schema-based registerTool API
• Removed manual parameter validation code (now handled automatically by Zod)
• Leveraged existing Zod dependency from MCP SDK

Full Changelog: v0.2.1...v0.2.2

0.2.1

Full Changelog: 0.2.0...0.2.1

🎉 clsync v0.2.0 - First Stable Release

Claude Code Environment Syncer - Sync your Claude Code settings across machines

✨ Features

🖥️ Interactive CLI

• Full-screen terminal mode (alternate screen buffer)
• Numeric menu selection for quick navigation
• Responsive UI (Full/Compact/Minimal modes based on terminal width)

🌐 Browse Online Repositories

• Discover curated Claude Code settings from the community
• One-click pull from online repository registry
• Seamless integration with pulled repositories browser

📦 Core Sync Features

• Stage settings from ~/.claude or .claude to staging area
• Apply settings to user or project scope
• Pull repositories from GitHub
• Promote/Demote settings between user and project scopes

🔧 MCP Server

• Full MCP (Model Context Protocol) integration
• Use with Claude Desktop or any MCP-compatible client
• 15+ tools for managing Claude Code settings

🏠 Links

• Homepage: https://clsync.lovable.app/
• GitHub: https://github.com/workromancer/clsync
• npm: https://www.npmjs.com/package/clsync

📦 Installation

npm install -g clsync