Cursor Setup

pip install atlas-mem

# atlas_memory.py
"""
Atlas memory helper for Cursor sessions.
Usage:
  python atlas_memory.py add "We decided to use Postgres over MySQL for ACID compliance."
  python atlas_memory.py search "database choice"
  python atlas_memory.py ask "Why did we choose Postgres?"
"""

import sys
import os
from atlas_mem import AtlasMem

brain = AtlasMem(
    api_key=os.environ["ATLAS_API_KEY"],
    base_url="https://api.bsyncs.com",
    user_id=os.environ.get("ATLAS_USER_ID", "cursor-dev"),
    persona=os.environ.get("ATLAS_PERSONA", "shared"),
    session_id=os.environ.get("ATLAS_SESSION_ID"),
)

def main():
    if len(sys.argv) < 3:
        print("Usage: python atlas_memory.py [add|search|ask] <text>")
        sys.exit(1)

    command = sys.argv[1]
    text = " ".join(sys.argv[2:])

    if command == "add":
        result = brain.add(text, source="user")
        print(f"Stored: {result.entities_extracted} entities, {result.triples_extracted} relations")

    elif command == "search":
        results = brain.search(text, k=5)
        print(results.format())

    elif command == "ask":
        answer = brain.ask(text, max_hops=3)
        print(answer)

    else:
        print(f"Unknown command: {command}")

if __name__ == "__main__":
    main()

export ATLAS_API_KEY="atlas_your_key_here"
export ATLAS_USER_ID="your-name"           # your personal namespace
export ATLAS_SESSION_ID="cursor-session"   # optional working memory

You have access to a long-term memory system called Atlas.

BEFORE answering architectural, technical, or project-specific questions, run:
  python atlas_memory.py search "<summary of the question>"
and include the retrieved context in your response.

AFTER making an important architectural decision, design choice, or discovering a non-obvious bug fix, run:
  python atlas_memory.py add "<concise fact about the decision>"

Facts worth storing:
- Technology choices and their rationale ("We use gRPC over REST for internal services because...")
- Non-obvious bug fixes ("The race condition in payment_service.py was caused by...")
- Team conventions ("All API responses use snake_case, never camelCase")
- Performance findings ("Redis pipeline batching reduced latency by 40% for bulk writes")
- Dependency notes ("Do not upgrade langchain-core above 0.2.40 — breaks graph transformer")

# Store your first architectural decision
python atlas_memory.py add "We use PostgreSQL as the primary database. Chose it over MySQL for better JSONB support and ACID compliance on complex transactions."

# Ask a question
python atlas_memory.py ask "Why do we use PostgreSQL?"