Skip to main content

Initializing Project Memory

Setting up Persistent Memory for a project is a one-time process that analyzes your codebase and builds a knowledge base for future scans.

Prerequisites​

  • An active paid subscription (Pro, Business, or Custom)
  • At least 500 credits ($5.00) available in your account
  • A free memory slot — your plan caps how many memories you can hold (Pro: 1, Business: 5, Custom: 5 by default). If you're at the cap, delete an existing memory first.

Step-by-Step Guide​

1. Navigate to Persistent Memory​

Go to Features in the sidebar, then select the Persistent Memory tab. You'll see a list of your existing project memories (if any) and a "New Project Memory" button.

Persistent Memory Tab

2. Start the Initialization​

Click "New Project Memory". This opens the scan stepper in memory initialization mode.

Memory Init Pricing

3. Configure Your Project​

Follow the same familiar steps as a regular scan:

  1. Select repository — Choose the project you want to build memory for. Repositories that already have memory are disabled to prevent duplicates.
  2. Select branch — Pick the branch to analyze.
  3. Select contracts — Choose which contracts to include.
  4. Add documentation — Optionally provide additional docs, Q&A, or links for richer context.

For details on each step, see the Getting Started guide.

4. Confirm and Launch​

The final step shows the Memory Initialization pricing card:

  • Cost: 500 credits ($5.00) — a flat fee regardless of project size
  • Duration: Up to 30 minutes
  • Your current balance and the balance after initialization are displayed

Memory Init Pricing

Click "Initialize Memory" to start. If you don't have enough credits, the button reads "Top Up and Initialize" and will guide you through adding credits first.

5. Track Progress​

After launching, you're redirected to the dashboard. A progress toast appears showing the initialization status with a percentage indicator.

Once complete, the toast shows a clickable link to view your new project memory.

tip

You can continue using AuditAgent normally while memory initializes. The process runs in the background and won't affect your other scans.

What Happens During Initialization​

AuditAgent performs a thorough analysis of your codebase to build the initial knowledge base:

  • Overview: A high-level summary of your project's architecture, dependencies, and key components
  • Invariants: Properties that should always hold true in your contracts (e.g., "total supply never exceeds max cap")
  • AST Analysis: Structural mapping of your contracts for accurate per-contract organization
  • Documentation: Any docs, Q&A, or links you provided are ingested and stored
  • Contradictions: Any detected mismatches between documented behavior and actual implementation

After Initialization​

Once initialization completes:

  • The memory status changes from Initializing to Ready
  • A brain icon appears on the project's scan card in your dashboard
  • You can access and manage the memory from the Features > Persistent Memory tab or by clicking the brain icon
  • All future scans of this project will automatically use the memory to improve results