@memsync/cli

MemSync CLI

Keep your project documentation automatically synchronized with code changes using LLM analysis.

What is MemSync?

MemSync is a CLI tool that monitors your git repository for code changes and uses Claude AI to automatically update your project's state.md file. This keeps your project documentation always in sync with reality.

Key Features:

• 🤖 LLM-Powered: Uses Claude to intelligently analyze code changes
• 📝 Automatic Updates: Updates relevant sections of your documentation
• 🔍 Smart Detection: Only syncs when changes are significant
• 🔐 Team-Friendly: Configuration stored in git for team collaboration
• ⚡ Fast: Analyzes diffs in ~25 seconds with Claude Haiku

Installation

Prerequisites

• Bun.js (or Node.js 22+)
• Git
• ANTHROPIC_API_KEY environment variable set

Via npm (coming soon)

bun install @memsync/cli

Local Development

cd packages/cli
bun install
bun src/cli.ts --help

Quick Start

1. Initialize MemSync in your project

memsync init

This will:

• Create .memsync/ directory with initial state.md
• Generate LLM.md with instructions for AI agents
• Create memsync.toml with configuration
• Commit these files to git

2. Check the status

memsync status

Shows:

• Last sync timestamp
• Number of commits since last sync
• Files changed since last sync

3. Sync after making changes

memsync sync

This will:

• Analyze code changes since last sync
• Ask Claude to update relevant sections
• Show you the proposed changes
• Ask for confirmation before committing

Use --yes to skip confirmation:

memsync sync --yes

Commands

memsync init

Initialize MemSync in a git repository.

Prompts for:

• Project name
• Brief description (optional)

Creates:

• .memsync/ directory with initial files
• memsync.toml configuration

memsync sync [--yes]

Analyze code changes and update state.md.

Options:

• --yes - Skip confirmation prompt

memsync status

Show synchronization status.

Displays:

• Last sync timestamp
• Number of commits since sync
• Files changed
• Whether state.md is up to date

Environment Variables

Required

• ANTHROPIC_API_KEY - Your Anthropic API key

Optional

• DEBUG - Set to enable debug logging

Example:

export ANTHROPIC_API_KEY="sk-ant-..."
export DEBUG=1
memsync sync

For AI Agents

If you're an AI agent (Claude, etc.) working on this project:

• Read .memsync/state.md to understand the project
• Check .memsync/LLM.md for instructions
• Run memsync sync after making changes to keep documentation in sync

Development

# Install dependencies
bun install

# Run CLI
bun src/cli.ts --help
bun src/cli.ts status

# Build
bun build src/cli.ts --target=bun --outfile=dist/memsync

License

MIT