Skip to content

bitjaru/codesyncer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

78 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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