Skip to content

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

License

Notifications You must be signed in to change notification settings

bitjaru/codesyncer

Repository files navigation

CodeSyncer

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

npm version License GitHub stars

한국어 | English


The Problem → The Solution

Problem Without CodeSyncer With CodeSyncer
Context loss Every session = start from scratch @codesyncer-* tags = permanent memory
Forgot to tag Changes go untracked codesyncer watch catches everything
Rules forgotten AI forgets guidelines mid-session Hooks auto-remind at optimal moments
Dangerous inference AI guesses prices, security, APIs Auto-pause on critical keywords

Demo

CodeSyncer Demo


Quick Start

# 1. Install
npm install -g codesyncer

# 2. Initialize
cd /path/to/your/project
codesyncer init

# 3. Let AI set up (say this to Claude)
"Read .claude/SETUP_GUIDE.md and follow the instructions"

# 4. Start coding (say this each session)
"Read CLAUDE.md"

Upgrade

npm install -g codesyncer@latest

Core Features

🏷️ Tag System

Put context IN your code. AI reads code, so it recovers context automatically.

// @codesyncer-decision: [2024-01-15] Using JWT (session management is simpler)
// @codesyncer-inference: Page size 20 (standard UX pattern)
const authConfig = { /* ... */ };

→ Tag System Guide


🔄 Watch Mode

Catch untagged changes in real-time:

codesyncer watch
[14:32:10] 📝 Changed: src/auth/login.ts
           └── 🎯 Found: @codesyncer-decision
           └── ✅ Added to DECISIONS.md

→ Advanced Usage


🪝 Hooks

Auto-remind AI at optimal moments (not every response):

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

CodeSyncer uses the most efficient hook timing.

→ Hooks Guide


Supported AI Tools

Tool Status
Claude Code ✅ Full support
Cursor 🚧 Coming soon
GitHub Copilot 🚧 Coming soon

Documentation

Guide Description
Setup Guide Installation, configuration, updating
Tag System All tags and examples
Hooks Guide Hook events and customization
Advanced Usage Watch mode, auto-discussion, monorepo
FAQ Common questions

Commands

codesyncer init       # Initialize project
codesyncer update     # Update templates
codesyncer validate   # Check setup
codesyncer watch      # Real-time monitoring
codesyncer add-repo   # Add repo to workspace
codesyncer skills     # Browse skills.sh leaderboard

Contributing

We welcome contributions! See CONTRIBUTING.md

Priority areas:

  • 🤖 Support for more AI tools
  • 🌐 Additional language translations
  • 📦 More tech stack templates

Support

If CodeSyncer helps you:

  • ⭐ Star this repo
  • 🐦 Share on Twitter

Ethereum (ETH):

0x0a12177c448778a37Fa4EeA57d33D06713F200De

License

Commons Clause + MIT - Free for personal/non-commercial use. See LICENSE


Contact


Built with ❤️ by the CodeSyncer community