Getting Started

Everything you need to get Dalexor running and connected to Claude, Cursor, or Windsurf in under 2 minutes.

⚡ Quick Start — under 2 minutes

Run these four commands and you're done. Your AI assistant will have persistent memory of your codebase.

# 1. Install pip install dalexor # 2. Authenticate (creates your config + API key) dx init # 3. Start watching your project (run from your project root) dx watch

✓ Restart your AI client. Dalexor tools will appear automatically.

How Dalexor works

Dalexor runs quietly in the background, watching for meaningful changes as you code. It converts those moments into a private history that your AI assistant can search and understand instantly.

Your Machine

Watches your files, measures changes, and prepares context without slowing you down.

Secure History

AI summarizes your changes and stores them in a private, searchable vault.

AI Integration

Brings your project memory directly into Claude, Cursor, or Windsurf.

Key Concepts

Project Snapshots

A snapshot is a saved moment in your project's history. It contains exactly what changed, an AI-written summary of the work, and how it impacts the rest of your code.

💡 Pro Tip: Snapshots are grouped by "Architectural Events" to prevent cluttering your history with tiny, unimportant saves.

Meaningful Changes Only

Dalexor doesn't just record every save. It reads what actually changed — the intent, the new functions, the structural shifts — and decides whether something is worth remembering. Reformatting a file or fixing an indent won't create a snapshot. Adding a new authentication flow will.

How Your Files Connect

As you work, Dalexor builds a live map of how your files depend on each other. When something changes in one place, your AI assistant already knows which other parts of the project are affected — before you even ask.

The Local Assistant

The local tool runs on your machine, watching your files and preparing updates before they are securely sent to your history.

How it helps:

Intelligent File Watching

Dalexor tracks file modifications in real-time. It's smart enough to ignore temporary files, build artifacts (like node_modules), and other noise, so it only focuses on your actual work.

Measuring Importance

Not every save is worth recording. Dalexor analyzes your change to see if it significantly alters the logic, structure, or function of your code before deciding to save a snapshot.

Connecting the Dots

As you work, the system maps out how your files are linked. It detects imports and references across dozens of languages, building a map of your project's architecture automatically.

Smart Updates

If you save a file ten times in a minute while debugging, Dalexor won't create ten separate entries. It waits for your work to settle, then creates one clean, meaningful record.

The Private Cloud

The cloud engine processes your updates, summarizes them with AI, and stores them in your private history vault.

How we handle your data:

Security & Isolation

Every request is locked down. We use industry-standard isolation to ensure that no one — not even our own engineers — can see your project history without your verified access keys.

AI Summarization

When you save code, an AI describes the change in plain English. This summary is what your assistant uses to remember your work — "Refactored login flow for performance" instead of just raw code changes.

Fast Natural Language Search

Your history is indexed so you can ask questions like "Why did we switch to Postgres last month?" and get an answer instantly.

Automatic History Chaining

Every snapshot is automatically linked to the version before it. This means you can trace the evolution of any feature or file from its first line of code to today.

Tool System

The system provides specialized tools that allow your AI assistant to query project information directly from your editor.

Indexed File Discovery

What it does: Lists all project files currently indexed in the cloud, allowing the agent to discover files by folder or recent activity.

Batch Tool Execution

What it does: Executes up to 10 MCP operations (like search, topology, and heritage) in parallel in a single round-trip.

Neural Concept Search

What it does: Finds code by meaning, not just exact text, using vector embeddings.

Trace Logic Heritage

What it does: Shows the full history of "why" a code decision was made, tagged by logic, security, or refactor.

Evolution Snapshots

What it does: Displays a timeline of conceptual shifts and architectural changes for any file.

Atomic Diffing

What it does: Provides high-granularity unified diffs with AI-summarized intent for recent refactors.

Predict Conflicts

What it does: Analyzes edit velocity to predict logical collisions across the team before they occur.

Map Project Topology

What it does: Visualizes structural relationships and call graphs for any target file.

Structural Intelligence

What it does: Instantly retrieves file skeletons (imports, classes, methods) without reading full bodies.

Find Definition

What it does: Gets the actual source code (up to 80 lines) of any function, class, or variable.

Trace Dependency

What it does: Finds every file and exact line where a symbol is used to map the blast radius.

Health & Status

What it does: Checks auth status, project ID, rate limits, and index freshness at a glance.

How your data flows

First: Local Detection

  1. You save a file in your editor
  2. The monitor detects the change
  3. Sentinel checks the file vs last version
  4. If changed, it marks the exact differences
  5. Measures how important the change is
  6. Detects code connections (imports)
  7. Adds to local memory buffer
  8. Sends grouping of changes to the cloud

Next: Cloud Sync

  1. Updates are sent via a secure connection
  2. The system confirms your project's identity
  3. Checks your current storage limits based on your plan
  4. Ensures your data is completely isolated from other projects
  5. If you have a private vault, your code is encrypted immediately
  6. The AI assistant summarizes the intent of your change
  7. Creates a searchable "memory marker" for the update
  8. Connects the new snapshot into your project's history chain
  9. Updates the map of which files depend on each other

Finally: Searching

  1. AI assistant uses a tool (e.g., search for code)
  2. Server receives the request
  3. Checks your access and security
  4. Runs search in the private history
  5. Decrypts if needed
  6. Returns results to the AI
  7. AI explains the answer to you

Security & Privacy

Your code is yours. Dalexor is built around the principle that developer work is private by default — not an afterthought.

Automatic Secret Protection

Before anything leaves your machine, Dalexor scans for and masks sensitive credentials — API keys, passwords, tokens — so they are never stored in your history. This happens locally, before any network call is made.

Private Vault (Paid Plans)

On Pro and Expert plans, your code history is encrypted before it ever leaves your machine using a private key that only you hold. We store an unreadable version of your data — only your authenticated connection can see the real content.

Total Privacy & Isolation

Every project exists in a completely sealed workspace. No account — not even ours — can access your data. Isolation is enforced at the storage level, not just the application layer.

Fair Usage

Usage limits scale with your plan to ensure a reliable experience for everyone. Higher tiers unlock more frequent syncing, deeper history, and faster query speeds. See our Pricing page for a full comparison.

Quick Start Integration

# 1. Install pip install dalexor # 2. Authenticate dx init # 3. Start watching your project dx watch # 4. Restart your AI client. Then try: # "What files import UserSession?" # → trace_dependency("UserSession") returns all dependents

CLI Commands

Dalexor runs from a simple CLI. Each command has a clear, single purpose.

dx init Links your local workspace to a Dalexor project. Run this once in a new directory to get started.
dx watch Starts real-time monitoring. Press R while running to launch the review popup inline. Press S to mark a milestone.
dx review Opens the High-Fidelity Review UI. Displays full file content, syntax highlighting, and side-by-side diffs for conflicts.
dx sync Scans your entire project at once. Best for joining an existing codebase or full project indexing.
dx chat Interactive CLI chat grounded in your actual project history and architecture.
dx restore Recover code by describing logical intent (e.g., 'bring back the auth middleware').

The High-Fidelity Review System

Unlike standard tools that show truncated snippets, Dalexor's Review UI provides a comprehensive view of team changes:

  • Full Context: View the entire file content, not just the changed lines, to understand the logical impact of every edit.
  • Live Syntax Highlighting: Professional-grade code rendering for all major languages, making reviews as readable as your IDE.
  • Visual Diffs: Clear color-coded indicators (Red for deletions/conflicts, Green for additions) with side-by-side comparison for remote version collisions.
  • Intent-Aware: The top info bar displays the author's custom commit message and the exact milestone tag for every code push.
  • Hotkeys & Flow: Use [R] to launch from the watch CLI, or let the popup auto-launch when a conflict is detected. Files auto-advance as you process them.

🧬 Mental Model: dx review vs Git

If you're coming from Git, here is how dx review maps to your existing workflow:

The Conflict (409)

Like a Git Push Rejection. When you save, dx watch tries to push. If a teammate pushed first, the server rejects your change because you're "behind" the remote.

Pending Reviews

Like the Git Index/Staging Area. The server creates a global ledger of what changed. Your disk isn't touched until you decide to act.

Accepting Changes

Like git merge --theirs. Dalexor fetches the remote version, pauses the observer, and writes the teammate's code directly to your disk.

Rejecting Changes

Like git checkout -- local_file. You keep your version, and Dalexor silently advances your baseline hash so the next save doesn't loop.

📌 Marking a Milestone

While dx watch is running, press S at any time to manually "Seal" your current state. You will be prompted for a commit message, marking a significant point in your project's history with human-readable intent.

Privacy Mode

Available on Pro and Expert plans, Privacy Mode gives you true ownership of your project history.

End-to-End Encryption

With Privacy Mode enabled, your code is encrypted on your own machine before it is ever transmitted. We hold an unreadable copy — only your authenticated session can access the real content. Not us, not anyone else.

Your Key, Your Control

You generate and own the Private Key. Share it with your AI assistant — but Dalexor never stores it. If you rotate or revoke it, your history becomes permanently inaccessible to anyone without the new key.

Advanced Features

Smart Grouping

Dalexor is smart enough to know when you're in the middle of a focused coding session. It won't flood your history with tiny updates while you're rapidly saving. It waits for you to finish a thought, then creates one clean record.

Dependency Recovery

When you create a brand new file, the system instantly links it to any other code in your history that might use it. Your map stays accurate from the very first second.

Recent Priority

Search results are weighted toward your most recent work. This ensures that when you ask questions, the answer is based on how your project looks now, not how it looked six months ago.