Stop losing AI development context.
Session archive · Conflict detection · Team dashboard for Claude Code teams and solo developers.
Quick Start · Project Site · Documentation
| Problem | Without ContextSync | With ContextSync |
|---|---|---|
| Lost context | Claude sessions scattered across local machines | Centralized archive with full-text search |
| Work conflicts | Discover file clashes at merge time | Real-time conflict detection by severity |
| Invisible progress | "What did the team build today?" | Dashboard with daily usage charts and activity stats |
Scans local Claude Code sessions (~/.claude/projects/) and syncs to the web dashboard. Active sessions grouped by project.
Detects simultaneous file modifications across team members. Classifies by severity (info / warning / critical) with review workflow.
Daily usage charts and 7-day activity stats — session counts, token usage, hot files, and team member activity at a glance.
More features
| Feature | Description |
|---|---|
| Local Auto-Sync | Background sync of local Claude sessions (~/.claude/projects/) on interval |
| Dual-DB Routing | Local + remote database for seamless team collaboration |
| PRD Analysis | Upload PRDs and track requirement fulfillment with Claude-powered analysis |
| Plans | Structured markdown plans linked to projects from ~/.claude/plans/ |
| Full-text Search | PostgreSQL tsvector search across sessions, messages, file paths, and tags |
| AI Evaluation | Multi-dimensional scoring of AI utilization with proficiency tiers |
| Team Collaboration | Role-based access (Owner / Member) with project sharing and invitations |
Prerequisites: Docker (Node.js 22 is auto-installed if missing)
git clone https://github.com/OkyoKwon/contextSync.git && cd contextSync
bash scripts/setup.sh
pnpm devsetup.sh auto-installs Node 22, starts Docker, runs DB migrations, and seeds sample data.
Then run pnpm dev to start the dev server. Open http://localhost:5173 and enter your name to get started.
Joining an existing team? Run
pnpm setup:teaminstead — no Docker required.For manual setup, prerequisites install, and environment variables, see the Setup Guide.
| Mode | Setup Command | Docker | Use Case |
|---|---|---|---|
| Personal | bash scripts/setup.sh |
Yes | Solo dev, local DB |
| Team Host | Setup guide → | Yes | Admin hosting shared DB (local + remote) |
| Team Member | pnpm setup:team && pnpm dev:profile <name> |
No | Join existing team project |
| Layer | Stack |
|---|---|
| Frontend | React 19, Vite 6, Tailwind CSS 4, Zustand 5, React Query 5, React Router 7 |
| Backend | Fastify 5, Kysely, Zod |
| Database | PostgreSQL 16 |
| Auth | Name-based identity + JWT |
| Monorepo | pnpm workspaces + Turborepo |
contextSync/
├── apps/
│ ├── api/ # Fastify API server (port 3001)
│ └── web/ # React SPA (port 5173)
├── packages/
│ └── shared/ # Shared types, validators, constants
└── docker-compose.yml
API Modules
apps/api/src/modules/
├── activity/ # Activity logging
├── admin/ # DB health, migrations, settings
├── ai-evaluation/ # AI utilization scoring
├── auth/ # Name-based identity + JWT
├── conflicts/ # Conflict detection & resolution
├── local-sessions/ # Local session scanning
├── notifications/ # Slack notifications
├── plans/ # Markdown planning documents
├── prd-analysis/ # PRD analysis with AI
├── projects/ # Project management
├── quota/ # Rate limit & quota tracking
├── search/ # Full-text search
├── sessions/ # Session import, sync, parsing
├── setup/ # Database connection & team setup
└── supabase-onboarding/ # Supabase guided setup
pnpm dev # Start all services (API + Web)
pnpm build # Build all packages
pnpm test # Run tests
pnpm test:coverage # Run tests with coverage (80% threshold)
pnpm typecheck # Type check all packages
pnpm lint # Lint all packages
pnpm setup:team # Team member interactive setupKey conventions — full guide in CONTRIBUTING.md:
- Module pattern:
routes → service → repository → schema(4-file structure) - Immutability: always return new objects, never mutate existing ones
- Testing: 80% coverage required —
pnpm test:coverage
Looking for a place to start? Check out good first issues. Please read our Code of Conduct before participating.
- Session export (JSON, CSV)
- GitHub integration (link sessions to PRs/issues)
- Real-time collaboration (WebSocket-based live sync)
- Plugin system for custom session processors
- Self-hosted Docker image (single
docker rundeployment) - VS Code extension for session management
Have an idea? Open a feature request.
- GitHub Issues — Bug reports & feature requests
- GitHub Discussions — Questions & ideas
Found a vulnerability? See SECURITY.md for reporting instructions.
Built with Fastify · React · Kysely · Vite · Tailwind CSS · Turborepo