User Guide & Documentation

Getting Started with AI-NEURON™

Connect your local codebase catalog natively to reasoning models. Get sub-millisecond AST context with zero cloud data leaks.

01

Step 1: Download & Install

AI-NEURON runs silently in the background of your operating system. Just download the installer, click "Next," and forget about it. It will automatically start with your computer and begin protecting your AI context.

Install and Forget

Once installed, you will see the AI-NEURON icon in your system tray (bottom right on Windows, top menu bar on Mac). It will automatically run on every restart. There are no manual scripts to run.

02

Step 2: Proactive AI Agent Integration

With the new Human Brain Context Engine, you do not need to configure anything. Whenever you open a project folder in your IDE, AI-NEURON automatically detects it and proactively injects your codebase memory directly into your agent's system prompt.

⛵ Cursor IDE & Windsurf

No setup required. AI-NEURON automatically updates the .cursorrules file in your project root with your exact memory context. Cursor reads this natively on every prompt.

🐚 Claude Code CLI

No setup required. AI-NEURON seamlessly manages the CLAUDE.md file in your active directory.

💻 Copilot, Grok, & Antigravity

The engine writes a master NEURON_CONTEXT.md file. These agents automatically discover it in the root path and load the evolution ledger into their context window.

03

Step 3: Local (Free) vs. Cloud Backup (Pro)

AI-NEURON operates on a privacy-first open-core model. Your codebase memories are yours. We do not force you to create an account to use the core local product.

The Free Local Experience

When you install AI-NEURON, the Local Memory Engine is 100% free forever. It silently creates a local index.sqlite database inside your project and feeds context to your AI agents natively. You do not need to log in, and zero data leaves your PC.

The Pro Cloud Upgrade

If you want your project memory to follow you to your laptop, office PC, or survive an accidental hard drive format, you can easily upgrade to Cloud Sync via the local Control Portal.

  • Cloud Sync Status: When AI-NEURON attempts to backup your memory to the cloud, the system tray will gently notify you that "Sync is Paused".
  • Activating the Service: Click the tray icon to open the Control Portal. Click "Upgrade to Cloud Sync" and securely check out via PayPal without ever leaving your local dashboard.
  • Auto-Sync Goes Live: Once payment succeeds, the system tray changes to "⏳ Syncing..." and securely uploads your memory deltas to our cloud servers automatically.
04

Loop Guardian: Runaway Loop Prevention

Autonomous coding agents can occasionally enter infinite loops—repeatedly executing failed compilation tasks, writing the same bug-ridden files, or calling test scripts in a circle. In minutes, this can consume millions of LLM API tokens.

AI-NEURON's built-in **Loop Guardian** monitors filesystem events and workspace edits inside a rolling time window. If an agent repeats identical file writes or re-indexing commands excessively, the Loop Guardian automatically intervenes:

🔄 Identical File Writes (5× in 60s)
If the agent rewrites the exact same file 5 times within a 60-second window, the client prints a terminal warning and enforces a mandatory **5-second debounce delay** to break the continuous cycle.
🛑 Unchanged Code Re-scans (3× in 300s)
If the agent attempts to force a full re-scan of the codebase 3 times within 300 seconds without any changes detected in the AST, the client **halts further execution** and alerts the developer.

📊 Loop Guardian Monitoring

Loop notifications are sent directly to your OS via native desktop notifications, and the system tray icon will change to a red alert state. You can also view recent alerts by clicking on the tray icon.

05

Step 5: Generate a Memory Digest (Audit Log)

Need to hand your project over to a new developer, or show your team what the AI agents accomplished this week? Use the built-in Information Blockchain Ledger to generate a human-readable executive summary.

Open your terminal and run the digest command to export the last 7 days of AI activity into a beautifully formatted Markdown file:

ai-neuron digest --days 7 --export ai_activity_log.md