# Clone the repository
git clone https://github.com/EldrexDelosReyesBula/CodeMemory.git
cd CodeMemory

# Install dependencies
npm install

# Build TypeScript
npm run build

# Initialize CodeMemory in your repository
npm run dev -- init

# Scan the current codebase and index all symbols
npm run dev -- scan

# Search for any function, class, or symbol
npm run dev -- query authenticateUser

# Extract token-budgeted AI context
npm run dev -- context AuthService --budget 2000

# Launch the interactive local Web Explorer (auto-opens browser)
npm run dev -- web
# or with explicit launch mode
npm run dev -- web --mode auto
npm run dev -- web --mode manual

# Start in background daemon mode
npm run dev -- web --daemon

# Start the live background file watcher (quiet mode available)
npm run dev -- watch
npm run dev -- watch --quiet

# Export Mermaid architecture diagram
npm run dev -- export --format mermaid

# Check repository health and statistics
npm run dev -- status

{
  "mcpServers": {
    "codememory": {
      "command": "npx",
      "args": ["-y", "@eldrex/codememory", "mcp"],
      "env": {}
    }
  }
}

CodeMemory/
├── src/
│   ├── types/          # Domain data types & contracts
│   ├── db/             # SQLite engine with WAL mode & indexes
│   ├── parser/         # Multi-language AST symbol & dependency extractor
│   ├── watcher/        # Real-time debounced file watcher with .gitignore
│   ├── git/            # Git commit and diff history monitor
│   ├── generator/      # Mermaid diagram & Markdown/JSON exporters
│   ├── context/        # Token-budgeted context assembly & symbol ranker
│   ├── mcp/            # Model Context Protocol stdio server
│   └── cli.ts          # CLI commands router
└── tests/              # Complete Vitest test suite

# Verify synchronization between Git-tracked files and CodeMemory index
codememory devdiff sync

# Check for untracked or unindexed files in workspace
codememory devdiff compare

# Analyze direct and indirect caller dependencies for specific files
codememory devdiff impact src/cli.ts

# View file change records and AST symbols
codememory devdiff explain src/cli.ts

# Start Unified MCP Server (combines CodeMemory and DevDiff tools)
codememory mcp --unified