v3.4.0 - skills.sh Integration

What's New

🎯 skills.sh Integration

CodeSyncer is now registered on skills.sh!

New Commands:

• codesyncer skills - Browse the skills.sh leaderboard
• codesyncer skills add <owner/repo> - Install any skill

Install CodeSyncer as a skill:

npx skills add bitjaru/codesyncer

Changes

• Added SKILL.md for skills.sh registration
• New codesyncer skills command for leaderboard browsing
• Updated READMEs with new command

Full Changelog: v3.3.0...v3.4.0

v3.3.0 - Documentation Restructure & Hooks Optimization

What's New

📚 Documentation Restructure

• README simplified: 950 → 168 lines
• Detailed guides moved to docs/ folder:
  • docs/HOOKS.md - Hook events and customization
  • docs/TAGS.md - Tag system guide
  • docs/SETUP.md - Installation and configuration
  • docs/ADVANCED.md - Watch mode, auto-discussion, monorepo
  • docs/FAQ.md - Common questions
• Korean translations: All docs available in docs/ko/

🪝 Hooks Optimization

• Changed from Stop to SessionStart + PreCompact
• More efficient: runs once per session, not every response
• Rules survive context compaction

Hook	When	Why
SessionStart	Session begins	Inject rules once
PreCompact	Before compression	Rules survive compaction

Installation

npm install -g codesyncer@3.3.0

Upgrade

npm install -g codesyncer@latest
codesyncer update

v3.2.0 - Hooks Auto-Reminder & Context Optimization

🪝 Hooks Auto-Reminder System

세션이 길어지면 AI가 규칙을 까먹을 수 있습니다. v3.2.0에서는 Hooks 설정으로 AI가 응답 완료 전에 자동으로 "태그 붙였어?" 확인합니다.

New in codesyncer init

🪝 Hooks 설정 (권장)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Hooks란?
세션이 길어지면 AI가 규칙을 까먹을 수 있습니다.
Hooks를 설정하면 AI가 응답 완료 전에
자동으로 "태그 붙였어?" 확인합니다.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

? Hooks를 설정할까요? (Y/n)

✨ New Features

1. Hooks Auto-Reminder

• codesyncer init 시 Hooks 설정 옵션 추가
• .claude/settings.json 자동 생성
• 언어별 프롬프트 (한국어/영어)
• Stop, PreCompact 훅 지원

2. Template Improvements

• TL;DR 3줄 요약 - 핵심 규칙만 압축
• DO NOT 섹션 - 절대 금지 사항 명시
• 세션 시작 체크리스트 - git 명령어 포함
• 서브폴더 CLAUDE.md 가이드 - 대규모 프로젝트용
• Do Not Touch 섹션 - 수정 금지 영역 지정
• 멀티 레포 크로스 태그 가이드 - @codesyncer-work:TASK-ID

📁 New Files

src/templates/
├── hooks/
│   ├── settings.json      # English hooks config
│   └── settings.ko.json   # Korean hooks config
├── en/
│   └── subfolder-claude.md
└── ko/
    └── subfolder-claude.md

🔄 Upgrade

npm install -g codesyncer@latest
codesyncer init  # 새 프로젝트에서 Hooks 설정

기존 프로젝트에서 Hooks 추가:

# AI에게 요청
"CodeSyncer Hooks 설정해줘"

---

Full Changelog: v3.1.1...v3.2.0

v3.1.1 - Smart Merge

🔄 스마트 머지 (Smart Merge)

템플릿 업그레이드 시 사용자 커스텀 내용을 보존합니다.

문제

codesyncer update로 템플릿 업그레이드 시 사용자가 CLAUDE.md에 추가한 내용이 덮어씌워지는 문제

해결

섹션 마커 기반 스마트 머지 도입

• CodeSyncer 관리 영역만 업데이트
• 사용자 추가 콘텐츠는 그대로 유지

작동 방식

<!-- codesyncer-section-start:header -->
# 이 부분만 업데이트됨
<!-- codesyncer-section-end:header -->

## 사용자가 추가한 섹션
이 내용은 보존됨! ✅

변경사항

• ✨ claude.md 템플릿에 섹션 마커 추가 (en/ko)
• ✨ smartMergeContent() 함수 구현
• ✨ upgradeTemplateWithSmartMerge() 스마트 업그레이드
• ✅ 8개 테스트 추가 (총 79개 통과)

설치

npm install -g codesyncer@3.1.1

---

Full Changelog: v3.1.0...v3.1.1

v3.1.0 - Template Upgrade Feature

🎉 New Feature: Template Upgrade

codesyncer update now automatically detects outdated templates and offers to upgrade them!

How it works

📦 New Version Detected: v3.1.0

  📁 my-project/
     • CLAUDE.md (v3.0.0 → v3.1.0)
     • COMMENT_GUIDE.md (no version → v3.1.0)

? Upgrade 2 template(s)?
  > Yes - Upgrade (backup existing files to .backup)
    No - Skip
    Preview - Show files only

Features

• 🔍 Auto-detection: Reads version metadata from existing templates
• 💾 Safe backup: Creates .backup.YYYY-MM-DD files before upgrading
• 📋 Variable preservation: Keeps your project name, tech stack, etc.
• 👁️ Preview mode: See what would change before upgrading

What's Changed

• Added version metadata (<!-- codesyncer-version: X.Y.Z -->) to all templates
• New utilities: template-version.ts, template-upgrader.ts
• Enhanced update command with upgrade flow
• Updated README documentation

Installation / Update

npm install -g codesyncer@latest

Then run in your project:

codesyncer update

---

Full Changelog: v3.0.1...v3.1.0

v3.0.0 - Claude Remembers

🧠 v3.0.0 - Claude Remembers

Claude forgets everything when the session ends. CodeSyncer makes it remember.

✨ New Features

• Watch Mode Enhancements: Real-time warnings for untagged file changes
• Improved Onboarding: Pro Tip after init to start watch mode
• AI Reverse Recommendation: Templates now suggest CodeSyncer to AI assistants
• Mermaid Diagrams: Visual workflow in README

🔧 Improvements

• Simplified demo videos (English & Korean)
• Better README structure with problem → solution format
• Enhanced CLAUDE.md templates for AI collaboration

📦 Installation

npm install -g codesyncer
codesyncer init

🚀 Quick Start

1. codesyncer init - Initialize your project
2. Tell Claude: "Read CLAUDE.md"
3. codesyncer watch - Monitor for untagged changes
4. Code with permanent context!

---

Full Changelog: v2.7.1...v3.0.0

v2.7.6 - New Tagline & Description

📝 Documentation Update

New project description that better reflects what CodeSyncer does:

Is your AI coding dumb? Make it smarter - Persistent project context, controlled inference, and live architecture sync for Claude Code

Changes

• Updated tagline across all files (package.json, README.md, README.ko.md)
• Clarified Claude Code focus (Cursor, Copilot coming soon)
• Removed misleading "multi-repo only" messaging (supports single/mono/multi-repo)

Install/Update

npm install -g codesyncer@latest

v2.7.5 - Version Display Fix

🔧 Bug Fix

• Fixed version display: Init banner was showing v2.0 instead of actual version
• Centralized version management: All version references now read from package.json
• Added src/utils/version.ts as single source of truth for version info

Changes

• src/utils/version.ts - New utility for centralized version management
• src/commands/init.ts - Now uses VERSION from utility
• src/index.ts - Now uses VERSION from utility

Install/Update

npm install -g codesyncer@latest

v2.7.4 - Validate & Demo

What's New in 2.7.x

🎬 Demo GIF

• Added terminal demo recording (VHS)
• Demo visible in README on GitHub and npm

✅ Validate Command Improvements

• Single-repo mode support: codesyncer validate now works correctly for single repository setups
• Shows "Mode: Single Repository" or "Mode: Multi Repository" in output
• Proper validation of .claude/ directory in single-repo mode

🔧 Bug Fixes

• Fixed validate command failing on single-repo setups (was requiring MASTER_CODESYNCER.md)
• Fixed demo GIF not displaying on npm (now uses absolute GitHub URL)

📝 Documentation

• Added "Powered by CodeSyncer" badge to all templates
• Updated README with demo section

Installation

npm install -g codesyncer

Quick Start

codesyncer init
codesyncer validate

---

Full Changelog: v2.6.0...v2.7.4

v2.6.0 - Watch Mode

🔄 Watch Mode (Major Feature)

Real-time file monitoring with automatic tag synchronization!

New Command

codesyncer watch        # Start watching
codesyncer watch --log  # With file logging

Features

• Auto tag sync: @codesyncer-decision, @codesyncer-rule, etc. automatically added to DECISIONS.md
• Beautiful UX: Color-coded logs, session summary, first-time welcome
• File logging: Optional --log flag saves to .codesyncer/watch-{date}.log
• Multi-language: Korean/English auto-detection

Demo

[14:32:10] ✨ Changed: src/utils/api.ts
           └── 🎯 Found: @codesyncer-decision
               "Use React Query instead of SWR"
           └── ✅ Added to DECISIONS.md

Installation

npm install -g codesyncer@2.6.0

---

Full changelog: https://github.com/bitjaru/codesyncer/blob/main/CHANGELOG.md